như được mô tả trongPhần 38.2, PostgreSQL10954_11105SQLNgôn ngữ. Tạo một tỷ lệ 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 tỷ lệ kèo bóng đá bằng ngôn ngữ cấp thấp, thường là C.

tỷ lệ kèo bóng đá 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ẫn11457_11506readmeTệp trong thư mục đó cho tỷ lệ kèo bóng đá hướng dẫn về chạy tỷ lệ kèo bóng đá ví dụ.

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

Giả sử chúng ta muốn xác định một tỷ lệ kèo bóng đáphức tạpđại diện cho tỷ lệ kèo bóng đá 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 phải biến tỷ lệ kèo bóng đá này thành một tham chiếu, vì nó quá lớn để phù hợp với mộtDatumGiá trị.

Là biểu diễn chuỗi bên ngoài của tỷ lệ 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 tỷ lệ 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ụ:

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 đá %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 đá 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.

14523_14864phứ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 đá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));

Một khi chúng tôi đã viết tỷ lệ kèo bóng đá 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 đá trong SQL. Đầu tiên chúng tôi khai báo nó là tỷ lệ kèo bóng đá shell:

Tạo tỷ lệ 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 tỷ lệ 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:

16109_16176FileName'
    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 đá 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
);

17069_17105PostgreSQLTự động cung cấp hỗ trợ cho các mảng thuộc tỷ lệ kèo bóng đá đó. tỷ lệ kèo bóng đá mảng thường có cùng tên với tỷ lệ kèo bóng đá cơ sở với ký tự dấu gạch dưới (_) Chuẩn bị.

Một khi tỷ lệ 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.

17661_17848Char [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 đá 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 tỷ lệ kèo bóng đálệnh.