Tất cả các cuộc gọi đến các chức năng được viết bằng soi kèo bóng đá truoctran ngôn ngữ khác ngoài hiện tạiHồiPhiên bản 1HồiGiao diện cho các soi kèo bóng đá truoctran ngữ được biên dịch (điều này bao gồm các hàm trong các soi kèo bóng đá truoctran ngữ và hàm thủ tục do người dùng xác địnhHandler gọiHàm cho ngôn ngữ cụ thể. Trình xử lý cuộc gọi là thực thi chức năng là soi kèo bóng đá truoctran cách có ý nghĩa, chẳng hạn như bằng cách diễn giải văn bản nguồn được cung cấp.
Trình xử lý cuộc gọi cho soi kèo bóng đá truoctran làbình thườngxôngHàm phải được viết bằng soi kèo bóng đá truoctran ngữ được biên dịch như C, sử dụng giao diện phiên bản-1 và được đăng ký vớiPostgreSQLnhư không có đối số và trả về loạisoi kèo bóng đá truoctran_handler
. Loại giả đặc biệt này xác định chức năng là người xử lý cuộc gọi và ngăn không cho nó được gọi trực tiếp trong các lệnh SQL.Phần 36.10.
Trình xử lý cuộc gọi được gọi theo cùng soi kèo bóng đá truoctran cách như bất kỳ chức năng nào khác: nó nhận được soi kèo bóng đá truoctran con trỏ tới AfunctionCallInfobasingata
struct
Chứa các giá trị và thông tin đối số về hàm được gọi và dự kiến sẽ trả về ADatum
Kết quả (và có thể đặtisnull
trường củafunctionCallInfobasingata
Cấu trúc, nếu nó muốn trả về kết quả SQL NULL). Sự khác biệt giữa trình xử lý cuộc gọi và hàm callee thông thường làflinfo- fn_oid
Trường củafunctionCallInfobasingata
Cấu trúc sẽ chứa oid của chức năng thực tế được gọi, không phải của chính trình xử lý cuộc gọi. Trình xử lý cuộc gọi phải sử dụng trường này để xác định chức năng thực thi nào.
Tùy thuộc vào trình xử lý cuộc gọi để lấy mục nhập của hàm từPG_PROC
Danh mục hệ thống và để phân tích đối số và các loại trả về của hàm được gọi. TheAS
mệnh đề từTạo chức năng
Lệnh cho chức năng sẽ được tìm thấy trongprosrc
Cột củaPG_PROC
Hàng. Đây thường là văn bản nguồn trong ngôn ngữ thủ tục, nhưng trên lý thuyết, nó có thể là soi kèo bóng đá truoctran cái gì đó khác, chẳng hạn như tên đường dẫn đến soi kèo bóng đá truoctran tệp hoặc bất cứ điều gì khác cho người xử lý cuộc gọi phải làm gì soi kèo bóng đá truoctran cách chi tiết.
Thông thường, cùng soi kèo bóng đá truoctran hàm được gọi là nhiều lần cho mỗi câu lệnh SQL. Trình xử lý cuộc gọi có thể tránh tra cứu thông tin lặp đi lặp lại về chức năng được gọi bằng cách sử dụngflinfo- fn_extra
Trường. Điều này ban đầu sẽ lànull
, nhưng có thể được đặt bởi trình xử lý cuộc gọi để chỉ vào thông tin về hàm được gọi. Trên các cuộc gọi tiếp theo, nếuflinfo- fn_extra
đã khôngnull
Sau đó, nó có thể được sử dụng và bước tra cứu thông tin bị bỏ qua. Người xử lý cuộc gọi phải đảm bảo rằngflinfo- fn_extra
được thực hiện để chỉ vào bộ nhớ sẽ sống ít nhất cho đến khi kết thúc truy vấn hiện tại, vì soi kèo bóng đá truoctranfmgrinfo
Cấu trúc dữ liệu có thể được giữ lâu. soi kèo bóng đá truoctran cách để làm điều này là phân bổ dữ liệu bổ sung trong bối cảnh bộ nhớ được chỉ định bởiflinfo- fn_mcxt
; Dữ liệu đó thường sẽ có tuổi thọ giống nhưfmgrinfo
chính nó. Nhưng trình xử lý cũng có thể chọn sử dụng bối cảnh bộ nhớ tồn tại lâu hơn để có thể bộ đệm thông tin định nghĩa chức năng trên các truy vấn.
Khi hàm soi kèo bóng đá truoctran được gọi dưới dạng kích hoạt, không có đối số nào được truyền theo cách thông thường, nhưngfunctionCallInfobasingata
'sbối cảnh
điểm trường tại ATriggerData
Cấu trúc, thay vì lànull
Vì nó là trong soi kèo bóng đá truoctran cuộc gọi chức năng đơn giản. soi kèo bóng đá truoctran người xử lý ngôn ngữ nên cung cấp các cơ chế cho các chức năng ngôn ngữ thủ tục để có được thông tin kích hoạt.
soi kèo bóng đá truoctran mẫu cho trình xử lý ngôn ngữ thủ tục được viết dưới dạng tiện ích mở rộng C được cung cấp trongsrc/test/modules/plsample
. Đây là soi kèo bóng đá truoctran mẫu làm việc thể hiện soi kèo bóng đá truoctran cách để tạo soi kèo bóng đá truoctran trình xử lý ngôn ngữ thủ tục, các tham số xử lý và trả về soi kèo bóng đá truoctran giá trị.
Mặc dù cung cấp trình xử lý cuộc gọi là đủ để tạo ngôn ngữ thủ tục tối thiểu, có hai chức năng khác có thể được cung cấp tùy chọn để làm cho ngôn ngữ thuận tiện hơn để sử dụng. Đây là soi kèo bóng đá truoctranTrình xác nhậnvà soi kèo bóng đá truoctranHandler nội tuyến. soi kèo bóng đá truoctran trình xác nhận có thể được cung cấp để cho phép kiểm tra cụ thể ngôn ngữ được thực hiện trong thời gianTạo chức năng. soi kèo bóng đá truoctran trình xử lý nội tuyến có thể được cung cấp để cho phép ngôn ngữ hỗ trợ các khối mã ẩn danh được thực thi thông quadolệnh.
Nếu soi kèo bóng đá truoctran trình xác nhận được cung cấp bởi soi kèo bóng đá truoctran ngôn ngữ thủ tục, nó phải được khai báo là soi kèo bóng đá truoctran hàm lấy soi kèo bóng đá truoctran tham số duy nhấtoid
. Kết quả của trình xác nhận bị bỏ qua, do đó, nó được tuyên bố thông thường để trả vềvoid
. Trình xác nhận sẽ được gọi vào cuốiTạo chức năng
Lệnh đã tạo hoặc cập nhật soi kèo bóng đá truoctran hàm được viết bằng ngôn ngữ thủ tục. OID được truyền qua là oid của chức năngPG_PROC
Hàng. Trình xác thực phải tìm nạp hàng này theo cách thông thường và làm bất cứ điều gì kiểm tra là phù hợp.CheckFunctionValidatorAccess ()
Để chẩn đoán các cuộc gọi rõ ràng đến trình xác nhận mà người dùng không thể đạt được thông quaTạo chức năng
. Kiểm tra điển hình sau đó bao gồm xác minh rằng các loại đối số và kết quả của hàm được hỗ trợ bởi soi kèo bóng đá truoctran ngữ và cơ thể của chức năng được chính xác về mặt cú pháp trong soi kèo bóng đá truoctran ngữ.EREPORT ()
Cơ chế báo cáo lỗi. Ném soi kèo bóng đá truoctran lỗi sẽ buộc soi kèo bóng đá truoctran cuộc quay đầu lại giao dịch và do đó ngăn chặn định nghĩa chức năng không chính xác được thực hiện.
Các chức năng của trình xác thực thường tôn trọngCheck_Function_BodiesTham số: Nếu nó bị tắt thì bất kỳ kiểm tra đắt tiền hoặc nhạy cảm với bối cảnh nên được bỏ qua. Nếu soi kèo bóng đá truoctran ngữ cung cấp thực thi mã tại thời điểm biên dịch, trình xác nhận phải triệt tiêu các kiểm tra sẽ gây ra thực thi đó.pg_dumpđể nó có thể tải các hàm soi kèo bóng đá truoctran mà không phải lo lắng về các tác dụng phụ hoặc phụ thuộc của các cơ quan chức năng trên các đối tượng cơ sở dữ liệu khác. .tạo chức năng
Lệnh.) Trong khi sự lựa chọn chính xác những gì cần kiểm tra hầu hết là theo quyết định của hàm xác thựcTạo chức năng
Mã chỉ thực thiset
mệnh đề gắn liền với soi kèo bóng đá truoctran hàm khiCheck_Function_Bodies
là trên. Do đó, kiểm tra kết quả của họ có thể bị ảnh hưởng bởi các tham số GUC chắc chắn nên được bỏ qua khiCheck_Function_Bodies
bị tắt, để tránh lỗi sai khi khôi phục lại.
Nếu soi kèo bóng đá truoctran trình xử lý nội tuyến được cung cấp bởi soi kèo bóng đá truoctran ngôn ngữ thủ tục, nó phải được khai báo là soi kèo bóng đá truoctran hàm lấy soi kèo bóng đá truoctran tham số duy nhất loạiNội bộ
. Kết quả của người xử lý nội tuyến bị bỏ qua, do đó, nó được tuyên bố thông thường để trả vềvoid
. Trình xử lý nội tuyến sẽ được gọi khido
Câu lệnh được thực thi chỉ định ngôn ngữ thủ tục. Tham số thực sự được truyền là soi kèo bóng đá truoctran con trỏ tớiInLineCodeBlock
struct, chứa thông tin vềdo
tham số của câu lệnh, đặc biệt là văn bản của khối mã ẩn danh sẽ được thực thi. Trình xử lý nội tuyến nên thực thi mã này và trả về.
Bạn nên bọc tất cả các khai báo chức năng này, cũng nhưTạo soi kèo bóng đá truoctran ngữ
lệnh chính nó, thành soi kèo bóng đá truoctranMở rộngVì vậy, đơn giảnTạo tiện ích mở rộng
Lệnh là đủ để cài đặt soi kèo bóng đá truoctran ngữ. Nhìn thấyPhần 36.17Để biết thông tin về việc viết tiện ích mở rộng.
Các soi kèo bóng đá truoctran có trong phân phối tiêu chuẩn là các tài liệu tham khảo tốt khi cố gắng viết trình xử lý ngôn ngữ của riêng bạn. Nhìn vàoSRC/PL
thư mục con của cây nguồn. TheTạo soi kèo bóng đá truoctran ngữTrang tham chiếu cũng có soi kèo bóng đá truoctran số chi tiết hữu ích.
Nếu bạn thấy bất cứ điều gì trong tài liệu không chính xác, không khớpMẫu nàyĐể báo cáo vấn đề tài liệu.