Tất cả các cuộc gọi đến các chức năng được viết bằng một kèo bóng đá c1 ngữ khác ngoài hiện tạiPhiên bản 1HồiGiao diện cho các kèo bóng đá c1 ngữ được biên dịch (điều này bao gồm các hàm trong các kèo bóng đá c1 ngữ và hàm thủ tục do người dùng xác địnhHandler gọiHàm cho kèo bóng đá c1 ngữ cụ thể. Trình xử lý cuộc gọi là thực thi chức năng là một 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 kèo bóng đá c1 làbình thườngxôngHàm phải được viết bằng kèo bóng đá c1 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ạikèo bóng đá c1_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 37.10.

kèo bóng đá c1 xử lý cuộc gọi được gọi theo cùng một cách như bất kỳ chức năng nào khác: nó nhận được một con trỏ tới AfunctionCallInfobasingata structchứa các giá trị đối số và thông tin về hàm được gọi và dự kiến ​​sẽ trả về ADatumKết quả (và có thể đặtisnullTrường củafunctionCallInfobasingataCấu trúc, nếu nó muốn trả về kết quả SQL NULL). Sự khác biệt giữa kèo bóng đá c1 xử lý cuộc gọi và hàm callee thông thường làflinfo- fn_oidtrường củafunctionCallInfobasingataCấ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 kèo bóng đá c1 xử lý cuộc gọi. kèo bóng đá c1 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 kèo bóng đá c1 xử lý cuộc gọi để lấy mục nhập của hàm từPG_PROCDanh 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. TheASmệnh đề từTạo chức năngLệnh cho chức năng sẽ được tìm thấy trongprosrcCột củaPG_PROCHàng. Đây thường là văn bản nguồn trong kèo bóng đá c1, nhưng trên lý thuyết, nó có thể là một cái gì đó khác, chẳng hạn như tên đường dẫn đến một 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ì một cách chi tiết.

Thông thường, chức năng tương tự được gọi là nhiều lần cho mỗi câu lệnh SQL. kèo bóng đá c1 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_extraTrường. Điều này ban đầu sẽ lànull, nhưng có thể được đặt bởi kèo bóng đá c1 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ôngnullSau đó, 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ì mộtfmgrinfoCấu trúc dữ liệu có thể được giữ lâu. Một 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ưfmgrinfochính nó. Nhưng kèo bóng đá c1 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 kèo bóng đá c1 đượ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 ATriggerDataCấu trúc, thay vì lànullNhư trong một cuộc gọi chức năng đơn giản. Một người xử lý ngôn ngữ nên cung cấp các cơ chế cho các chức năng kèo bóng đá c1 để có được thông tin kích hoạt.

Đây là một mẫu cho một trình xử lý kèo bóng đá c1 được viết bằng C:

#include "Postgres.h"

Chỉ có vài nghìn dòng mã phải được thêm vào thay vì các dấu chấm để hoàn thành kèo bóng đá c1 xử lý cuộc gọi.

Sau khi biên dịch hàm xử lý thành một mô -đun có thể tải (xemPhần 37.10.5), Các lệnh sau sau đó đăng ký kèo bóng đá c1 mẫu:

Tạo chức năng plsample_call_handler () trả về kèo bóng đá c1_handlerFileName'

Mặc dù cung cấp trình xử lý cuộc gọi là đủ để tạo kèo bóng đá c1 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à mộtkèo bóng đá c1 xác nhậnvà mộtHandler nội tuyến. Một trình xác nhận có thể được cung cấp để cho phép kiểm tra cụ thể kèo bóng đá c1 ngữ được thực hiện trong thời gianTạo chức năng. Một trình xử lý nội tuyến có thể được cung cấp để cho phép kèo bóng đá c1 ngữ hỗ trợ các khối mã ẩn danh được thực thi thông quadolệnh.

Nếu một trình xác nhận được cung cấp bởi một kèo bóng đá c1, nó phải được khai báo là một hàm lấy một tham số duy nhất loạioid. Kết quả của kèo bóng đá c1 xác nhận bị bỏ qua, do đó, nó được tuyên bố thông thường để trả vềvoid. kèo bóng đá c1 xác nhận sẽ được gọi vào cuốiTạo chức năngLệnh đã tạo hoặc cập nhật một hàm được viết bằng kèo bóng đá c1. OID được truyền qua là oid của chức năngpg_procHàng. kèo bóng đá c1 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 kèo bóng đá c1 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 kèo bóng đá c1 ngữ và cơ thể của chức năng được chính xác về mặt cú pháp trong kèo bóng đá c1 ngữ.EREPORT ()Cơ chế báo cáo lỗi. Ném một lỗi sẽ buộc một 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 kèo bóng đá c1 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 kèo bóng đá c1 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để có thể tải các hàm kèo bóng đá c1 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ăngLệnh.) Trong khi 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ăngMã chỉ thực thisetmệnh đề được gắn vào một hàm khiCheck_Function_Bodieslà 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_Bodiesbị tắt, để tránh lỗi sai khi khôi phục lại.

Nếu một trình xử lý nội tuyến được cung cấp bởi một kèo bóng đá c1, nó phải được khai báo là một hàm lấy một 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. kèo bóng đá c1 xử lý nội tuyến sẽ được gọi khidoCâu lệnh được thực thi chỉ định kèo bóng đá c1. Tham số thực sự được truyền là một con trỏ tớiInLineCodeBlockstruct, chứa thông tin vềdotham 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. kèo bóng đá c1 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 kèo bóng đá c1 ngữlệnh chính, thành mộtMở rộngsao cho đơn giảnTạo tiện ích mở rộngLệnh là đủ để cài đặt kèo bóng đá c1 ngữ. Nhìn thấyPhần 37.17Để biết thông tin về việc viết tiện ích mở rộng.

Các kèo bóng đá c1 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/PLthư mục con của cây nguồn. TheTạo kèo bóng đá c1 ngữTrang tham chiếu cũng có một số chi tiết hữu ích.