như được mô tả trongPhần 36.2, PostgreSQLcó thể được mở rộng để hỗ trợ các kèo bóng đá euro dữ liệu mới. Phần này mô tả cách xác định các kèo bóng đá euro cơ sở mới, là các kèo bóng đá euro dữ liệu được xác định dưới mức củaSQLNgôn ngữ. Tạo một kèo bóng đá euro cơ sở mới yêu cầu thực hiện các chức năng để hoạt động trên kèo bóng đá euro bằng ngôn ngữ cấp thấp, thường là C.

kèo bóng đá euro ví dụ trong phần này có thể được tìm thấy trongphức tạp.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 kèo bóng đá euro hướng dẫn về chạy kèo bóng đá euro ví dụ.

Một kèo bóng đá euro do người dùng xác định 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 kèo bóng đá euro 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 kèo bóng đá euro 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 kèo bóng đá euro. Hàm đầu ra lấy biểu diễn nội bộ của kèo bóng đá euro 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 kèo bóng đá euro 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 kèo bóng đá euro.

Giả sử chúng ta muốn xác định một kèo bóng đá europhức tạp12509_12634

Typedef Struct Complex 
    gấp đôi x;
    gấp đôi y;
 Tổ hợp;

Chúng ta sẽ cần biến kèo bóng đá euro này thành một kèo bóng đá euro tham chiếu quaDatumGiá trị.

Là biểu diễn chuỗi bên ngoài của kèo bóng đá euro, 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 kèo bóng đá euro, 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ụ:

pg_function_info_v1 (Complex_in);

Mốc thời gian
Complex_in (pg_function_args)

    char *str = pg_getarg_cstring (0);
    gấp đôi x,
                y;
    Phức tạp *kết quả;

    if (sscanf (str, "( %lf, %lf)", & x, & y)! = 2)
        ereport (lỗi,
                (errcode (errcode_invalid_text_representation),
                 errmsg ("cú pháp đầu vào không hợp lệ cho kèo bóng đá euro %s: \" %s \ "",
                        "phức tạp", str)));

    result = (phức hợp *) palloc (sizeof (phức tạp));
    Kết quả- x = x;
    kết quả- y = y;
    Pg_return_pulum (result);

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 kèo bóng đá euro 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, kèo bóng đá euro 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 kèo bóng đá euro 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 kèo bóng đá eurofloat8:

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));

Một 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 dùng chung, chúng tôi có thể kèo bóng đá europhức tạpkèo bóng đá euro trong SQL. Đầu tiên chúng tôi khai báo nó là kèo bóng đá euro shell:

Tạo kèo bóng đá euro 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 kèo bóng đá euro trong khi xác định các chức năng 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 'FileName16253_16356FileName'
    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 kèo bóng đá euro 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 kèo bóng đá euro cơ sở mới,PostgreSQL17175_17325_) Chuẩn bị.

Một khi kèo bóng đá euro 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 chiều dài) trong trường này vàvarsize ()Để lấy nó. (kèo bóng đá euro 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 kèo bóng đá eurolệnh.