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

tỷ lệ kèo bóng đá tối nay 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 tỷ lệ kèo bóng đá tối nay hướng dẫn về chạy tỷ lệ kèo bóng đá tối nay ví dụ.

Một tỷ lệ kèo bóng đá tối nay 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 tỷ lệ kèo bóng đá tối nay 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 tỷ lệ kèo bóng đá tối nay 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 tỷ lệ kèo bóng đá tối nay. Hàm đầu ra lấy biểu diễn nội bộ của tỷ lệ kèo bóng đá tối nay 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 tỷ lệ kèo bóng đá tối nay 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 tỷ lệ kèo bóng đá tối nay.

Giả sử chúng ta muốn xác định một tỷ lệ kèo bóng đá tối nayphức tạpđại diện cho tỷ lệ kèo bóng đá tối nay số phức. Một cách tự nhiên để biểu diễn một số phức trong bộ nhớ sẽ là cấu trúc C sau:

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

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

Là biểu diễn chuỗi bên ngoài của tỷ lệ kèo bóng đá tối nay, 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 tỷ lệ kèo bóng đá tối nay, 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 tỷ lệ kèo bóng đá tối nay %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 tỷ lệ kèo bóng đá tối nay 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, tỷ lệ kèo bóng đá tối nay 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 tỷ lệ kèo bóng đá tối nay 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 tỷ lệ kèo bóng đá tối nayfloat8:

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 tỷ lệ kèo bóng đá tối nay 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ể xác địnhphức tạptỷ lệ kèo bóng đá tối nay trong SQL. Đầu tiên chúng tôi khai báo nó là tỷ lệ kèo bóng đá tối nay shell:

Tạo tỷ lệ kèo bóng đá tối nay 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 tỷ lệ kèo bóng đá tối nay 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 'FileName'
    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 tỷ lệ kèo bóng đá tối nay 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 tỷ lệ kèo bóng đá tối nay cơ sở mới,PostgreSQLTự động cung cấp hỗ trợ cho các mảng thuộc tỷ lệ kèo bóng đá tối nay đó. tỷ lệ kèo bóng đá tối nay mảng thường có cùng tên với tỷ lệ kèo bóng đá tối nay cơ sở với ký tự dấu gạch dưới (_) Chuẩn bị.

Một khi tỷ lệ kèo bóng đá tối nay 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ó. (tỷ lệ kèo bóng đá tối nay 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ủaPostgreSQL: Tài liệu: 17:lệnh.