34.9. kèo bóng đá pháp ngữ c

34.9.1. Tải động

Lần đầu tiên chức năng do người dùng định nghĩa trong kèo bóng đá pháp cụ thểTạo kèo bóng đá pháp năngcho a

Thuật toán sau được sử dụng để định vị đối tượng chia sẻTạolệnh:

1. Nếu tên là đường dẫn tuyệt đối, tệp đã cho là

2. Nếu tên bắt đầu bằng chuỗi$ libdir, phần đó được thay thế bằngPostgreSQLThư viện gói

3. Nếu tên không chứa phần thư mục, tệpDynamic_l Library_path.

4. Nếu không (tệp không được tìm thấy kèo bóng đá pháp đường dẫn hoặc nó

Nếu chuỗi này không hoạt động,.so) được gắn vào tên đã cho và cái này

Nên định vị kèo bóng đá pháp thư viện được chia sẻ$ libdirhoặc thông qua động lực$ libdircó thể tìm thấypg_config.

ID người dùngPostgreSQLMáy chủ chạy vì phải có thể đi qua đường dẫn đến tệpPostgresNgười dùng là kèo bóng đá pháp sai lầm phổ biến.

kèo bóng đá pháp mọi trường hợp, tên tệp được đưa ra kèo bóng đá phápTạo kèo bóng đá pháp năngLệnh được ghi lại theo nghĩa đen kèo bóng đá pháp

Để đảm bảo rằng kèo bóng đá pháp tệp đối tượng được tải động là khôngPostgreSQLKiểm tra xem tệp có chứa"Khối ma thuật"với thích hợpPostgreSQL. kèo bóng đá pháp phép thuậtPostgreSQL8.2. Bao gồm kèo bóng đá pháp khối ma thuật,fmgr.h:

#ifdef pg_module_magic

The#ifdefCó thể bỏ qua kiểm tra nếuPostgreSQLphát hành.

Sau khi nó được sử dụng lần đầu tiên,

Tùy chọn, kèo bóng đá pháp tệp được tải động có thể chứa_pg_init, Đó là_pg_fini, kèo bóng đá pháp năng đó sẽ được gọi_pg_finisẽ chỉ được gọi

34.9.2. kèo bóng đá pháp loại cơ sở bằng tiếng c

Để biết cách viết kèo bóng đá pháp chức năng ngôn ngữ C, bạn cần biếtPostgreSQLnội bộPostgreSQLcoi loại cơ sở là"Blob of Memory". Người dùng định nghĩaPostgreSQLCó thể hoạt động trênPostgreSQLWill

kèo bóng đá pháp loại cơ sở có thể có một trong ba định dạng nội bộ:

• Pass by giá trị, độ dài cố định

• Pass by tham chiếu, độ dài cố định

• Pass by tham chiếu, độ dài biến

kèo bóng đá pháp loại giá trị chỉ có thể có chiều dài 1, 2 hoặc 4 byte (cũngsizeof (mốc dữ liệu)là 8 trênLongLoại nguy hiểmintLoại là 4 byte trên hầu hết kèo bóng đá pháp UnixINT4gõ trên máy Unix có thể là:

/ * số nguyên 4 byte, được truyền bởi giá trị */

Mặt khác, kèo bóng đá pháp loại có độ dài cố định có thểPostgreSQLloại:

/ * Cấu trúc 16 byte, được truyền qua tham chiếu */

Chỉ có thể sử dụng kèo bóng đá pháp gợi ý cho kèo bóng đá pháp loại như vậy khi chuyển chúng vàoPostgreSQLchức năng. Để trả về giá trị của kèo bóng đá pháp loại như vậy, hãy phân bổ quyềnPalloC, điền vàoPalloCVà chỉ cần trả lại con trỏ cho

Cuối cùng, tất cả kèo bóng đá pháp loại có độ dài thay đổi cũng phải được truyền qua

Ví dụ, chúng ta có thể xác định loạiTextnhư sau:

typedef struct

Rõ ràng, trường dữ liệu được khai báo ở đây không đủ dàiC, Chúng tôi dựa vào kiến ​​thức rằngCTrình biên dịch sẽ không kiểm tra phạm vi

Khi thao tác kèo bóng đá pháp loại có độ dài biến, chúng ta phải cẩn thậnTextcấu trúc, chúng ta có thể sử dụng

#include "Postgres.h"

Varhdrszgiống nhưsizeof (int4), nhưng nó được coi là phong cách tốt đểVarhdrszđể tham khảo

Bảng 34-1Chỉ định loại c tương ứng với loại SQL khiPostgreSQL. The"Được xác định kèo bóng đá pháp"Cột đưa ra tệp tiêu đề màPostgres.hĐầu tiên kèo bóng đá pháp bất kỳ tệp nguồn nào, vì nó

Bây giờ chúng tôi đã vượt qua tất cả kèo bóng đá pháp cấu trúc có thể

34.9.3.

Chúng tôi trình bày"Kiểu cũ"Gọi quy ước trước - mặc dù cách tiếp cận này hiện là

Đây là kèo bóng đá pháp số ví dụ:

#include "Postgres.h"

Giả sử rằng mã trên đã được chuẩn bị kèo bóng đá pháp tệpfuncs.cvà biên dịch thành kèo bóng đá pháp chia sẻPostgreSQLVới kèo bóng đá pháp lệnh như thế này:

Tạo kèo bóng đá pháp add_one (số nguyên) Trả về số nguyênThư mục/funcs ',' add_one 'Thư mục/funcs ',' add_one_float8 'Thư mục/funcs ',' makepoint 'Thư mục/funcs ',' copytext 'Thư mục/funcs ',' concat_text '

ở đây,Thư mụcPhía trênPOSTGRESQLThư mục hướng dẫn,'funcs'kèo bóng đá phápASmệnh đề, sau khi đã thêmThư mụcđến đường dẫn tìm kiếm. kèo bóng đá pháp bất kỳ.sohoặc.SL.)

Lưu ý rằng chúng tôi đã chỉ định kèo bóng đá pháp chức năng là"nghiêm ngặt", nghĩa là hệ thống nên

Mặc dù quy ước gọi này là đơn giản để sử dụng, nhưng nó không phảiintCách này. Ngoài ra, không có cách nào đơn giản để

34.9.4.

Quy ước gọi phiên bản-1 dựa trên kèo bóng đá pháp macro để

Datum funcname (pg_function_args)

Ngoài ra, cuộc gọi macro:

pg_function_info_v1 (funcname);

phải xuất hiện trong cùng kèo bóng đá pháp tệp nguồn. (Thông thường, nóNội bộ-LanguagePOSTGRESQLGiả sử rằng tất cả kèo bóng đá pháp chức năng nội bộ đều sử dụng phiên bản-1

Trong kèo bóng đá pháp phiên bản-1, mỗi đối số thực tế được tìm nạppg_getarg_xxx()Macro tương ứng vớipg_return_xxx()Macro cho loại trả về.pg_getarg_xxx()lấy đối số của nópg_return_xxx()lấy đối số của nó

Ở đây chúng tôi hiển thị kèo bóng đá pháp chức năng giống như trên, được mã hóa trong phiên bản-1

#include "Postgres.h"

TheTạo kèo bóng đá pháp năngkèo bóng đá pháp lệnh là

Thoạt nhìn, kèo bóng đá pháp quy ước mã hóa phiên bản-1 có thểadd_one_float8, chúng ta không còn cần phải biếtfloat8là loại tham chiếu qua.GetArgMacro cho kèo bóng đá pháp loại có độ dài thay đổi cho phép hiệu quả hơn"Nướng"(nén hoặc

Một cải tiến lớn về kèo bóng đá pháp chức năng phiên bản-1 tốt hơnpg_argisnull (n)Cho phép kiểm tra kèo bóng đá pháp năng"nghiêm ngặt".) Như vớipg_getarg_xxx()macro, kèo bóng đá pháp đối số đầu vàopg_getarg_xxx()Cho đến khi người ta xác minh rằngpg_return_null (); Điều này hoạt động kèo bóng đá pháp

kèo bóng đá pháp tùy chọn khác được cung cấp trong giao diện kiểu mới là haipg_getarg_xxx()Macros. Cái đầu tiên kèo bóng đá pháp số này,pg_getarg_xxx_copy (), đảm bảo trả lại apg_getarg_xxx_copy ()macro đảm bảo apg_getarg_xxx_slice ()macro lấy"Bên ngoài". (Loại lưu trữThay đổiTableNameCột thay đổicolnameĐặt lưu trữStorAgetype. Storagetypelà kèo bóng đá pháp trongtrơn, bên ngoài, Mở rộnghoặcchính.)

​​Cuối cùng, kèo bóng đá pháp quy ước gọi chức năng phiên bản-1 làm cho nóPhần 34.9.10) vàChương) và Trình xử lý cuộc gọi bằng kèo bóng đá pháp ngữ thủ tục (Chương 48). Mã phiên bản-1 cũng nhiều hơnsrc/backend/utils/fmgr/readmein

34.9.5.

Trước khi chúng ta chuyển sang kèo bóng đá pháp chủ đề nâng cao hơn, chúng ta nênPostgreSQLkèo bóng đá pháp hàm ngôn ngữ c. Trong khi nóPostgreSQL, Điều này

kèo bóng đá pháp quy tắc cơ bản để viết và xây dựng kèo bóng đá pháp chức năng C là

• sử dụngpg_configĐể tìm ra nơiPOSTGRESQLkèo bóng đá pháp tệp tiêu đề máy chủ là

• biên dịch và liên kết mã của bạn để có thểPOSTGRESQLLuôn yêu cầu đặc biệtPhần 34.9.6Để được giải thích chi tiết về cách thực hiện cho bạn

• Hãy nhớ xác định A"Phép thuậtĐối với thư viện chia sẻ của bạn, như được mô tả kèo bóng đá phápPhần.

• Khi phân bổ bộ nhớ, hãy sử dụngPostgreSQLkèo bóng đá pháp năngPalloCvàPFREEThay vì thư viện C tương ứngmallocvàmiễn phí. Bộ nhớ được phân bổ bởiPalloCsẽ được giải phóng

• Luôn bằng không kèo bóng đá pháp byte của cấu trúc của bạn bằng cách sử dụngmemset. Không có điều này, nó là

• Hầu hết kèo bóng đá pháp bên trongPostgreSQLkèo bóng đá pháp loại được khai báo trongPostgres.h, kèo bóng đá pháp khi chức năngpg_function_args, v.v.)fmgr.h, vì vậy bạn sẽ cần phải bao gồm tạiPostgres.h Đầu tiên, trước bất kỳPostgres.hcũng sẽ bao gồmELOG.Hvàpalloc.hcho bạn.

• Tên biểu tượng được xác định trong kèo bóng đá pháp tệp đối tượng không đượcPostgreSQLMáy chủ

34.9.6. Biên soạn

Trước khi bạn có thể sử dụngPostgreSQLkèo bóng đá pháp chức năng mở rộng được viết trongThư viện chia sẻCần phải có

Để biết thông tin vượt ra ngoài những gì có kèo bóng đá pháp phần này bạnCCvà Trình chỉnh sửa liên kết,LD. Ngoài ra,POSTGRESQLMã nguồn chứa kèo bóng đá pháp sốĐóng gópThư mục. Nếu bạn dựa vào những ví dụ này, bạn sẽ làmPostgreSQLTuy nhiên, mã nguồn.

Tạo thư viện chia sẻ thường tương tự như liên kếtMã độc lập vị trí(pic),Điều gì có nghĩa là chúng có thể được đặt tại kèo bóng đá pháp

Trong kèo bóng đá pháp ví dụ sau, chúng tôi cho rằng mã nguồn của bạn làfoo.cvà chúng tôi sẽ tạo kèo bóng đá phápfoo.so. kèo bóng đá phápfoo.otrừ khi có ghi chú khác. kèo bóng đá pháp thư viện được chia sẻ

Tệp thư viện chia sẻ kết quả sau đó có thể được tải vàoPostgreSQL. Khi chỉ địnhtạo kèo bóng đá pháp năngLệnh, người ta phải đặt tên cho tệp thư viện được chia sẻ,.sohoặc.SL) có thểTạo kèo bóng đá pháp năngLệnh và thông thường nên được bỏ qua để tốt nhất

Tham khảo lạiPhầnGiới thiệu về nơi máy chủ mong đợi tìm được chia sẻ

34.9.7. Tòa nhà mở rộng

Nếu bạn đang nghĩ về việc phân phốiPostgreSQLMô -đun mở rộng, thiết lập APostgreSQLCài đặt cung cấp cơ sở hạ tầng xây dựng cho kèo bóng đá pháp phần mở rộng,PGXS, vì vậy đơn giảnPOSTGRESQL; nó chỉ đơn giản là tự động hóa chung

Để sử dụng cơ sở hạ tầng cho phần mở rộng của bạn, bạn phải viếtPGXSMakefile. Đây là kèo bóng đá pháp ví dụ màISBN_ISSNBao gồm kèo bóng đá pháp thư viện chia sẻ, SQL

mô -đun = isbn_issn

Ba dòng cuối cùng phải luôn giống nhau. Sớm hơnlàmquy tắc.

kèo bóng đá pháp biến sau có thể được đặt:

hoặc nhiều nhất là kèo bóng đá pháp trong hai:

phần sau cũng có thể được đặt:

Đặt makefile này làMakefileinlàmđể biên dịch và sau đóTạo cài đặtĐể cài đặt mô -đun của bạn. Theo mặc định,PostgreSQLCài đặt tương ứngpg_configChương trình tìm thấypg_configĐể trỏ đến nópg_configChương trình, kèo bóng đá pháp Makefile hoặclàmdòng lệnh.

kèo bóng đá pháp tập lệnh được liệt kê trongThủy loạnBiến được sử dụng để kiểm tra hồi quy mô -đun của bạn, chỉTạo Installcheckđược sử dụng choPostgreSQLMáy chủ. VìSQL/kèo bóng đá pháp thư mục mở rộng của bạn, kèo bóng đá pháp đó.sql,,Thủy loạnDanh sách kèo bóng đá pháp Makefile. Cho mỗi bài kiểm tramong đợi/, với.out. kèo bóng đá pháp bài kiểm tra được thực hiện bởiTạo InstallcheckvàRepression.diffsinDiffĐịnh dạng. Lưu ý rằng cố gắng chạy kèo bóng đá pháp bài kiểm tra bị thiếu"Sự cố", vì vậy hãy chắc chắn rằng bạn đã mong đợi tất cả

34.9.8.

kèo bóng đá pháp loại tổng hợp không có bố cục cố định như CPostgreSQLcung cấp kèo bóng đá pháp chức năng

Giả sử chúng ta muốn viết kèo bóng đá pháp chức năng để trả lời truy vấn:

Chọn Tên, C_OverPaid (EMP, 1500) làm trả quá nhiều tiền

Sử dụng quy ước gọi phiên bản 0, chúng ta có thể xác địnhc_overpaidAs:

#include "Postgres.h"

kèo bóng đá pháp mã hóa phiên bản-1, ở trên sẽ trông như thế này:

#include "Postgres.h"

GetAttributionByNamelàPostgreSQLkèo bóng đá pháp hệ thốngHeaptupleHeaderđược chuyển vào kèo bóng đá pháp năng, tênGetAttributionByNameTrả về ADatumGiá trị mà bạn có thể chuyển đổi sang dữ liệu phù hợpDatumgetxxx()Macro. Lưu ý rằng giá trị trả về là vô nghĩa nếu null

Ngoài ra còn cóGetAttributionByNum, chọn mục tiêu

Lệnh sau tuyên bố kèo bóng đá phápc_overpaidkèo bóng đá pháp SQL:

Tạo kèo bóng đá pháp năng C_overpaid (EMP, Integer) Trả về BooleanThư mục/funcs ',' c_overpaid '

Thông báo chúng tôi đã sử dụngnghiêm ngặtsao cho

34.9.9.

Để trả lại giá trị loại hoặc loại tổng hợp từ kèo bóng đá pháp ngữ c

#include "funcapi.h"

Có hai cách bạn có thể xây dựng giá trị dữ liệu tổng hợp"tuple"): Bạn có thểtupledescMô tả cho cấu trúc tuple. Khi làm việc với kèo bóng đá pháp mốc dữ liệu,tupledescđếnBlesstupledesc, rồi gọiheap_form_tuplecho mỗi hàng.tupledescđếntupledescgetattinmetadata, rồi gọibuildTupleFromCstringscho mỗi

kèo bóng đá pháp số chức năng trợ giúp có sẵn để thiết lậptupledesc. Được đề xuất

70229_70409

Vượt qua cùng kèo bóng đá phápfcinfoCấu trúcresultTypeIDcó thể được chỉ định lànullhoặc là địa chỉ của biến cục bộ đểresulttupledescnên là địa chỉ của kèo bóng đá pháp địa phươngtupledescBiến. Kiểm tra xemTYPEFUNC_COMPISE; Nếu vậy,resulttupledescđã được lấp đầy vớitupledesc. (Nếu nó là"Hồ sơ trả về chức năng được gọi kèo bóng đá pháp bối cảnh rằng.)

kèo bóng đá pháp chức năng cũ hơn, hiện đang được ghi nhận để có đượctupledescs là:

TUPLEDESC quan hệ

để nhậntupledesccho hàng

73093_73154

để nhậntupledescDựa trên atupledesccho loại cơ sở hoặc loại tổng hợp. NóRecordTuy nhiên, và nó không thể giải quyết

kèo bóng đá pháp khi bạn cótupledesc,,

73595_73642

Nếu bạn có kế hoạch làm việc với kèo bóng đá pháp mốc dữ liệu, hoặc:

73728_73791

Nếu bạn có kế hoạch làm việc với kèo bóng đá pháp chuỗi C. Nếu bạn đang viết mộtfunccallcontextCấu trúc - Sử dụngTuple_deschoặcAttinMetatrường tương ứng.

Khi làm việc với mốc dữ liệu, sử dụng:

74197_74274

để xây dựng AHeaptupleNgười dùng đã cho

Khi làm việc với kèo bóng đá pháp chuỗi C, sử dụng:

74453_74530

Để xây dựng AHeaptupleNgười dùng đã choGiá trịlà kèo bóng đá phápGiá trịmảng phải được đặt thànhnull. kèo bóng đá pháp năng này sẽ cần phải

kèo bóng đá pháp khi bạn đã xây dựng kèo bóng đá pháp tuple để trở về từ chức năng của mình, nóDatum. Sử dụng:

75272_75310

Để chuyển đổi Athành aDatumcó thể được trả về

kèo bóng đá pháp ví dụ xuất hiện trong phần tiếp theo.

34.9.10. Trả về kèo bóng đá pháp bộ

Ngoài ra còn có API đặc biệt cung cấp hỗ trợ chofuncapi.h, như trên.

kèo bóng đá pháp hoàn trả SET (SRF) được gọi kèo bóng đá pháp lần cho mỗi mục nóSRFPhảifunccallcontextđược cung cấp để giúp kiểm soátfcinfo- flinfo- fn_extrađược sử dụng để giữ kèo bóng đá phápfunccallcontextBên kia

Cấu trúc typedef

ANSRFSử dụng kèo bóng đá pháp sốfunccallcontextCấu trúc (vàfn_extra).

srf_is_firstcall ()

Để xác định xem kèo bóng đá pháp năng của bạn có được gọi cho lần đầu tiên

srf_firstcall_init ()

Để khởi tạofunccallcontext. Trên mọi cuộc gọi kèo bóng đá pháp năng,

srf_percall_setup ()

Để thiết lập đúng cách sử dụngfunccallcontextvà xóa bất kỳ trước đó

Nếu kèo bóng đá pháp năng của bạn có dữ liệu để trả về, hãy sử dụng:

srf_return_next (funcctx, result)

Để trả lại cho người gọi. (resultphải loạiDatum, hoặc là kèo bóng đá pháp

srf_return_done (funcctx)

Để làm sạch và kết thúcSRF.

bối cảnh bộ nhớ hiện tại khiSRFđược gọi là bối cảnh thoáng qua màPFREETrên mọi thứ bạnPalloC; nó sẽmulti_call_memory_ctxlà kèo bóng đá pháp vị trí phù hợpSRFđược hoàn thành chạy. Trong hầu hết kèo bóng đá pháp trường hợp,Multi_call_memory_ctxkèo bóng đá pháp khi làm

kèo bóng đá pháp ví dụ giả giả hoàn chỉnh trông giống như sau:

DatumKhai báo tiếp theo khi cầnif (srf_is_firstcall ()))Mã người dùng
        Nếu trả về composite
            Build tupledesc và có lẽ là attinmetadata
        endif trả về composite
        Mã người dùngMemoryContextSwitchto (OldContext);Mã người dùngfuncctx = srf_percall_setup ();Mã người dùng/ * Đây chỉ là kèo bóng đá pháp cách chúng tôi có thể kiểm tra xem chúng tôi đã hoàn thành: */Mã người dùng
        có được dữ liệu kết quảsrf_return_next (funcctx, result);Mã người dùngsrf_return_done (funcctx);

kèo bóng đá pháp ví dụ hoàn chỉnh về đơn giảnSRFTrả lại kèo bóng đá pháp loại tổng hợp trông

pg_function_info_v1 (retcposite);

kèo bóng đá pháp cách để khai báo chức năng này trong SQL là:

Tạo loại __retComposite AS (số nguyên F1, số nguyên F2, số nguyên F3);FileName',' retcposite '

Một cách khác là sử dụng kèo bóng đá pháp tham số:

Tạo hoặc thay thế chức năng retcposite (kèo bóng đá pháp số nguyên, kèo bóng đá pháp số nguyên,FileName',' retcposite '

Lưu ý rằng trong phương pháp này, loại đầu ra của kèo bóng đá phápRecordloại.

Thư mụcPRINT/TABLEFUNCin

34.9.11.

kèo bóng đá pháp hàm ngôn ngữ C có thể được khai báo để chấp nhận và trả lạiAnyEuity, AnyArray, AnynonarrayvàAnyenum. Nhìn thấyPhầnĐể giải thích chi tiết hơn về đa hìnhfmgr.hĐể cho phép kèo bóng đá pháp năng phiên bản-1 Cget_fn_expr_rettype (fmgrinfo *flinfo)vàget_fn_expr_argtype (fmgrinfo *flinfo, int. Họ trả về kết quả hoặc loại đối số oid hoặckhông hợp lệNếu thông tin khôngflinfoISfcinfo- flinfo. Tham sốArgnumlà không dựa trên.GET_CALL_RESULT_TYPEcũng có thể được sử dụng như kèo bóng đá phápget_fn_expr_rettype.

Ví dụ: giả sử chúng ta muốn viết kèo bóng đá pháp chức năng để chấp nhận a

pg_function_info_v1 (make_array);

Lệnh sau tuyên bố kèo bóng đá phápmake_arraykèo bóng đá pháp SQL:

Tạo kèo bóng đá pháp năng Make_array (AnyEuity) trả về AnyArrayThư mục/funcs ',' make_array '

34.9.12.

add-ins có thể bảo lưu lwlocks và phân bổ chia sẻshared_preload_l Libries. Bộ nhớ chia sẻ được bảo lưu bằng cách gọi:

void requestAddInshmemSpace (int size)

Từ bạn_pg_initfunction.

LWlocks được bảo lưu bằng cách gọi:

void requestAddInlWlocks (int n)

từ_pg_init.

Để tránh điều kiện chủng tộc có thể, mỗi phụ trợ nên sử dụngaddinshmeminitlockKhi kết nối và khởi tạo phân bổ chia sẻ của nó

MyStruct static *ptr = null;