như được mô tả trongPhần 37.2, PostgreSQLcó thể được mở rộng để hỗ trợ các cách đọc kèo bóng đá dữ liệu mới. Phần này mô tả cách xác định các cách đọc kèo bóng đá cơ sở mới, là các cách đọc kèo bóng đá dữ liệu được xác định dưới mức củaSQLNgôn ngữ. Tạo một cách đọc kèo bóng đá cơ sở mới yêu cầu thực hiện các chức năng để hoạt động trên cách đọc kèo bóng đá bằng ngôn ngữ cấp thấp, thường là C.
cách đọc kèo bóng đá ví dụ trong phần này có thể được tìm thấy trongComplex.sqlvàphức tạp.ctrongSRC/Hướng dẫnThư mục phân phối nguồn. XemreadmeTệp trong thư mục đó cho cách đọc kèo bóng đá hướng dẫn về chạy cách đọc kèo bóng đá ví dụ.
Một cách đọc kèo bóng đá do người dùng định nghĩa phải luôn có các chức năng đầu vào và đầu ra. Các chức năng này xác định cách cách đọc kèo bóng đá xuất hiện trong chuỗi (cho đầu vào của người dùng và đầu ra cho người dùng) và cách sắp xếp cách đọc kèo bóng đá trong bộ nhớ. Hàm đầu vào có chuỗi ký tự kết thúc null làm đối số của nó và trả về biểu diễn bên trong (trong bộ nhớ) của cách đọc kèo bóng đá. Hàm đầu ra lấy biểu diễn nội bộ của cách đọc kèo bóng đá làm đối số và trả về chuỗi ký tự kết thúc null. Nếu chúng tôi muốn làm bất cứ điều gì với cách đọc kèo bóng đá hơn là chỉ lưu trữ nó, chúng tôi phải cung cấp các chức năng bổ sung để thực hiện bất kỳ hoạt động nào chúng tôi muốn có cho cách đọc kèo bóng đá.
Giả sử chúng ta muốn xác định một cách đọc kèo bóng đáphức tạp12879_13004
Typedef Struct Complex
gấp đôi x;
gấp đôi y;
Tổ hợp;
Chúng ta sẽ cần biến cách đọc kèo bóng đá này thành một cách đọc kèo bóng đá tham chiếu quaDatumGiá trị.
Là biểu diễn chuỗi bên ngoài của cách đọc kèo bóng đá, chúng tôi chọn một chuỗi của biểu mẫu(x, y).
Các hàm đầu vào và đầu ra thường không khó để viết, đặc biệt là chức năng đầu ra. Nhưng khi xác định biểu diễn chuỗi bên ngoài của cách đọc kèo bóng đá, hãy nhớ rằng cuối cùng bạn phải viết trình phân tích cú pháp hoàn chỉnh và mạnh mẽ cho biểu diễn đó làm chức năng đầu vào của bạn. Ví dụ:
13718_14285
Hàm đầu ra có thể chỉ là:
pg_function_info_v1 (Complex_out);
Mốc thời gian
Complex_out (pg_function_args)
Phức hợp *phức tạp = (phức tạp *) pg_getarg_pulum (0);
char *kết quả;
result = psprintf ("(%g,%g)", phức tạp- x, phức tạp- y);
Pg_return_cstring (kết quả);
Bạn nên cẩn thận để thực hiện cách đọc kèo bóng đá hàm đầu vào và đầu ra nghịch đảo của nhau. Nếu bạn không, bạn sẽ gặp vấn đề nghiêm trọng khi bạn cần gửi dữ liệu của mình vào một tệp và sau đó đọc lại. Đây là một vấn đề đặc biệt phổ biến khi có liên quan đến số điểm nổi.
Tùy chọn, cách đọc kèo bóng đá do người dùng xác định có thể cung cấp các thói quen đầu vào và đầu ra nhị phân. I/O nhị phân thường nhanh hơn nhưng ít di động hơn I/O văn bản. Như với I/O văn bản, tùy thuộc vào bạn để xác định chính xác biểu diễn nhị phân bên ngoài là gì. Hầu hết các cách đọc kèo bóng đá dữ liệu tích hợp cố gắng cung cấp biểu diễn nhị phân độc lập với máy. Vìphức tạp, chúng tôi sẽ cõng trên các bộ chuyển đổi I/O nhị phân cho cách đọc kèo bóng đáfloat8:
pg_function_info_v1 (Complex_Recv);
Mốc thời gian
Complex_Recv (pg_function_args)
StringInfo buf = (StringInfo) pg_getArg_pulum (0);
Phức tạp *kết quả;
result = (phức hợp *) palloc (sizeof (phức tạp));
Kết quả- x = pq_getMSGFLOAT8 (BUF);
kết quả- y = pq_getMSGFLOAT8 (BUF);
Pg_return_pulum (result);
Pg_function_info_v1 (Complex_send);
Mốc thời gian
Complex_Send (pg_function_args)
Phức hợp *phức tạp = (phức tạp *) pg_getarg_pulum (0);
StringInfodata buf;
PQ_BegInTypsend (& buf);
pq_sendfloat8 (& buf, phức tạp- x);
pq_sendfloat8 (& buf, phức tạp- y);
Pg_return_bytea_p (pq_endtypsend (& buf));
Khi chúng tôi đã viết các hàm I/O và biên dịch chúng thành một thư viện được chia sẻ, chúng tôi có thể cách đọc kèo bóng đáphức tạpcách đọc kèo bóng đá trong SQL. Đầu tiên chúng tôi khai báo nó là cách đọc kèo bóng đá shell:
Tạo cách đọc kèo bóng đá phức tạp;
Điều này đóng vai trò là người giữ chỗ cho phép chúng tôi tham chiếu cách đọc kèo bóng đá trong khi xác định các hàm I/O của nó. Bây giờ chúng ta có thể xác định các chức năng I/O:
Tạo chức năng Complex_in (cString)
Trả lại phức tạp
BẰNG '16603_16613'
Ngôn ngữ C bất biến nghiêm ngặt;
Tạo chức năng Complex_out (phức tạp)
Trả lại cstring
BẰNG 'FileName'
Ngôn ngữ C bất biến nghiêm ngặt;
Tạo chức năng Complex_Recv (nội bộ)
Trả lại phức tạp
BẰNG 'FileName'
Ngôn ngữ C bất biến nghiêm ngặt;
Tạo chức năng Complex_Send (phức tạp)
Trả lại bytea
BẰNG 'FileName'
Ngôn ngữ C bất biến nghiêm ngặt;
Cuối cùng, chúng ta có thể cung cấp định nghĩa đầy đủ về kiểu dữ liệu:
Tạo cách đọc kèo bóng đá phức tạp ( InterlitalLight = 16, input = Complex_in, output = Complex_out, nhận = Complex_Recv, send = Complex_Send, Căn chỉnh = gấp đôi );
Khi bạn xác định cách đọc kèo bóng đá cơ sở mới,PostgreSQLTự động cung cấp hỗ trợ cho các mảng thuộc cách đọc kèo bóng đá đó. cách đọc kèo bóng đá mảng thường có cùng tên với cách đọc kèo bóng đá cơ sở với ký tự dấu gạch dưới (_) Chuẩn bị.
Một khi cách đọc kèo bóng đá dữ liệu tồn tại, chúng ta có thể khai báo các chức năng bổ sung để cung cấp các hoạt động hữu ích trên kiểu dữ liệu. Các toán tử sau đó có thể được xác định trên đỉnh các chức năng và nếu cần, các lớp toán tử có thể được tạo để hỗ trợ lập chỉ mục của kiểu dữ liệu. Các lớp bổ sung này được thảo luận trong các phần sau.
Nếu biểu diễn bên trong của kiểu dữ liệu có độ dài thay đổi, biểu diễn bên trong phải tuân theo bố cục tiêu chuẩn cho dữ liệu có độ dài thay đổi: bốn byte đầu tiên phải làChar [4]trường không bao giờ được truy cập trực tiếp (được đặt tên thông thườngVL_LEN_). Bạn phải sử dụngset_varsize ()Macro để lưu trữ tổng kích thước của mốc dữ liệu (bao gồm cả trường độ dài) trong trường này vàvarsize ()để lấy nó. (cách đọc kèo bóng đá macro này tồn tại vì trường Độ dài có thể được mã hóa tùy thuộc vào nền tảng.)
Để biết thêm chi tiết, hãy xem mô tả củaTạo cách đọc kèo bóng đálệnh.
Nếu cách đọc kèo bóng đá giá trị của kiểu dữ liệu của bạn khác nhau về kích thước (ở dạng bên trong), thì thường mong muốn tạo kiểu dữ liệuPostgresql: Tài-able (xemPhần 69.2). Bạn nên làm điều này ngay cả khi cách đọc kèo bóng đá giá trị luôn quá nhỏ để được nén hoặc lưu trữ bên ngoài, vìbánh mì nướngcũng có thể tiết kiệm không gian trên dữ liệu nhỏ, bằng cách giảm chi phí tiêu đề.
để hỗ trợbánh mì nướngLưu trữ, cách đọc kèo bóng đá chức năng C hoạt động trên kiểu dữ liệu phải luôn cẩn thận để giải nén bất kỳ giá trị nướng nào mà chúng được trao bằng cách sử dụngpg_detoast_datum. (Chi tiết này được ẩn theo thông thường bằng cách xác định cách đọc kèo bóng đá cụ thểgetarg_datatype_pMacros.) Sau đó, khi chạyTạo cách đọc kèo bóng đálệnh, chỉ định độ dài bên trong làBiếnvà chọn một số tùy chọn lưu trữ phù hợp kháctrơn.
Nếu căn chỉnh dữ liệu là không quan trọng (chỉ cho một hàm cụ thể hoặc vì kiểu dữ liệu chỉ định căn chỉnh byte) thì có thể tránh được một số chi phí củapg_detoast_datum. Bạn có thể sử dụngpg_detoast_datum_packedThay vào đó (theo thông thường được ẩn bằng cách cách đọc kèo bóng đáGetArg_Datatype_ppMacro) và sử dụng macroVarsize_any_exhdrvàVardata_anyĐể truy cập một mốc dữ liệu có khả năng đóng gói. Một lần nữa, dữ liệu được trả về bởi cách đọc kèo bóng đá macro này không được căn chỉnh ngay cả khi định nghĩa kiểu dữ liệu chỉ định căn chỉnh. Nếu căn chỉnh là quan trọng, bạn phải trải qua thông thườngpg_detoast_datumGiao diện.
Mã cũ thường xuyên khai báoVL_LEN_như mộtINT32trường thay vìChar [4]. Điều này ổn miễn là định nghĩa cấu trúc có cách đọc kèo bóng đá trường khác có ít nhấtINT32Căn chỉnh. Nhưng thật nguy hiểm khi sử dụng một định nghĩa cấu trúc như vậy khi làm việc với một mốc dữ liệu có khả năng không được sắp xếp; Trình biên dịch có thể lấy nó làm giấy phép để giả sử Datum thực sự được căn chỉnh, dẫn đến cách đọc kèo bóng đá kết xuất cốt lõi trên cách đọc kèo bóng đá kiến trúc nghiêm ngặt về căn chỉnh.
Một tính năng khác được kích hoạt bởibánh mì nướng21682_21725Mở rộngBiểu diễn dữ liệu trong bộ nhớ thuận tiện hơn để làm việc với định dạng được lưu trữ trên đĩa. Thông thường hoặcFlatĐịnh dạng lưu trữ Varlena cuối cùng chỉ là một đốm byte; Ví dụ, nó không thể chứa con trỏ, vì nó có thể được sao chép vào các vị trí khác trong bộ nhớ. Đối với các cách đọc kèo bóng đá dữ liệu phức tạp, định dạng phẳng có thể khá tốn kém để làm việc, vì vậyPostgreSQLCung cấp một cách đểHồiMở rộngHàng22299_22447
Để sử dụng lưu trữ mở rộng, kiểu dữ liệu phải cách đọc kèo bóng đá định dạng mở rộng tuân theo các quy tắc được đưa ra trongSRC/bao gồm/Utils/ExpandedDatum.h, và cung cấp cách đọc kèo bóng đá chức năng choMở rộngGiá trị varlena phẳng thành định dạng mở rộng vàFlattenHồiĐịnh dạng mở rộng trở lại đại diện varlena thông thường. Sau đó đảm bảo rằng tất cả cách đọc kèo bóng đá hàm C cho kiểu dữ liệu có thể chấp nhận biểu diễn, có thể bằng cách chuyển đổi một chức năng khác ngay khi nhận được. Điều này không yêu cầu sửa tất cả cách đọc kèo bóng đá chức năng hiện có cho kiểu dữ liệu cùng một lúc, vì tiêu chuẩnpg_detoast_datumMacro được cách đọc kèo bóng đá để chuyển đổi đầu vào mở rộng thành định dạng phẳng thông thường. Do đó, các chức năng hiện có hoạt động với định dạng Varlena phẳng sẽ tiếp tục hoạt động, mặc dù hơi kém hiệu quả, với các đầu vào mở rộng; Chúng không cần phải được chuyển đổi cho đến khi và trừ khi hiệu suất tốt hơn là quan trọng.
23487_24441VARATT_IS_EXPANDER_HEADER ()Macro để cách đọc kèo bóng đá định dạng nào họ nhận được.
Thebánh mì nướngCơ sở hạ tầng không chỉ cho phép cách đọc kèo bóng đá giá trị varlena thông thường được phân biệt với cách đọc kèo bóng đá giá trị mở rộng, mà còn phân biệtHồiRead-WriteHồivàChỉ đọc24855_25621
Để biết cách đọc kèo bóng đá ví dụ về làm việc với cách đọc kèo bóng đá giá trị mở rộng, hãy xem Cơ sở hạ tầng mảng tiêu chuẩn, đặc biệtSRC/Backend/Utils/ADT/Array_Expanding.C.