như được mô tả trongPhần 37.2,PostgreSQLcó thể được mở rộng để hỗ trợ tỷ lệ kèo bóng đá tối nay loại dữ liệu mới. Phần này mô tả cách xác định tỷ lệ kèo bóng đá tối nay loại cơ sở mới, là tỷ lệ kèo bóng đá tối nay loại dữ liệu được xác định dưới mức củaSQLNgôn ngữ. Tạo một loại cơ sở mới yêu cầu thực hiện tỷ lệ kèo bóng đá tối nay chức năng để hoạt động trên loại 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 loại do người dùng xác định phải luôn có tỷ lệ kèo bóng đá tối nay chức năng đầu vào và đầu ra. tỷ lệ kèo bóng đá tối nay chức năng này xác định cách loại 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 loại trong bộ nhớ.
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
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).
tỷ lệ kèo bóng đá tối nay 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 loại, 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.
pg_function_info_v1 (Complex_in);
Hàm đầu ra có thể chỉ là:
pg_function_info_v1 (Complex_out);
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, loại do người dùng xác định có thể cung cấp tỷ lệ kèo bóng đá tối nay 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.phức tạp, chúng tôi sẽ cõng trên tỷ lệ kèo bóng đá tối nay bộ chuyển đổi I/O nhị phân cho loạifloat8:
pg_function_info_v1 (Complex_Recv);
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 loại trong khi xác định tỷ lệ kèo bóng đá tối nay chức năng I/O của nó. Bây giờ chúng ta có thể xác định tỷ lệ kèo bóng đá tối nay chức năng I/O:
Tạo chức năng Complex_in (cString)FileName'FileName'FileName'FileName'
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 (
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 tỷ lệ kèo bóng đá tối nay mảng thuộc loại đó. Loại mảng thường có cùng tên với loại cơ sở với ký tự dấu gạch dưới (_) Chuẩn bị.
Một khi loại dữ liệu tồn tại, chúng ta có thể khai báo tỷ lệ kèo bóng đá tối nay chức năng bổ sung để cung cấp tỷ lệ kèo bóng đá tối nay hoạt động hữu ích trên kiểu dữ liệu. tỷ lệ kèo bóng đá tối nay toán tử sau đó có thể được xác định trên đỉnh tỷ lệ kèo bóng đá tối nay chức năng và nếu cần, tỷ lệ kèo bóng đá tối nay lớp toán tử có thể được tạo để hỗ trợ lập chỉ mục của kiểu dữ liệu.
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ó. (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ủaTạo tỷ lệ kèo bóng đá tối naylệnh.
Nếu tỷ lệ kèo bóng đá tối nay 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 kèo bóng-Able (xemPhần 69.2). Bạn nên làm điều này ngay cả khi tỷ lệ kèo bóng đá tối nay giá trị luôn quá nhỏ để được nén hoặc lưu trữ bên ngoài, vìPostgresql: Tài liệu:cũ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ữ, tỷ lệ kèo bóng đá tối nay hàm 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 tỷ lệ kèo bóng đá tối nay cụ thểGetArg_Datatype_PMacros.) Sau đó, khi chạyTạo tỷ lệ kèo bóng đá tối naylệ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ỉ là một hàm cụ thể hoặc vì tỷ lệ kèo bóng đá tối nay 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 tỷ lệ kèo bóng đá tối nayGetArg_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 tỷ lệ kèo bóng đá tối nay 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.pg_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ó tỷ lệ kèo bóng đá tối nay 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;
Một tính năng khác được kích hoạt bởibánh mì nướngHỗ trợ là khả năng cóMở 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 tỷ lệ kèo bóng đá tối nay vị trí khác trong bộ nhớ.PostgreSQLCung cấp một cách đểMở rộngĐịnh dạng phẳng thành một biểu diễn phù hợp hơn với tính toán, sau đó chuyển định dạng đó trong bộ nhớ giữa tỷ lệ kèo bóng đá tối nay hàm của kiểu dữ liệu.
Để sử dụng lưu trữ mở rộng, kiểu dữ liệu phải xác định định dạng mở rộng tuân theo tỷ lệ kèo bóng đá tối nay quy tắc được đưa ra trongSRC/bao gồm/Utils/ExpandedDatum.h, và cung cấp tỷ lệ kèo bóng đá tối nay chức năng choMở rộngGiá trị varlena phẳng thành định dạng mở rộng vàHồiFlattenKhănĐị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ả tỷ lệ kèo bóng đá tối nay chức năng 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.pg_detoast_datumMacro được xác định để chuyển đổi đầu vào mở rộng thành định dạng phẳng thông thường. Do đó, tỷ lệ kèo bóng đá tối nay 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 tỷ lệ kèo bóng đá tối nay đầu vào mở rộng;
C tỷ lệ kèo bóng đá tối nay chức năng biết cách làm việc với biểu diễn mở rộng thường rơi vào hai loại: tỷ lệ kèo bóng đá tối nay chức năng chỉ có thể xử lý định dạng mở rộng và tỷ lệ kèo bóng đá tối nay loại có thể xử lý tỷ lệ kèo bóng đá tối nay đầu vào varlena mở rộng hoặc phẳng. Cái trước dễ viết hơn nhưng có thể kém hiệu quả hơn, bởi vì việc chuyển đổi đầu vào phẳng sang hình thức mở rộng để sử dụng bởi một hàm duy nhất có thể có giá cao hơn được lưu bằng cách vận hành trên định dạng mở rộng.VARATT_IS_EXPANDER_HEADER ()Macro để tỷ lệ kèo bóng đá tối nay định dạng nào họ nhận được.
Thebánh mì nướngCơ sở hạ tầng không chỉ cho phép tỷ lệ kèo bóng đá tối nay giá trị varlena thông thường được phân biệt với tỷ lệ kèo bóng đá tối nay giá trị mở rộng, mà còn phân biệtMạnhRead-WritexôngvàChỉ đọcHồiCon trỏ đến tỷ lệ kèo bóng đá tối nay giá trị mở rộng. C tỷ lệ kèo bóng đá tối nay chức năng chỉ cần kiểm tra giá trị mở rộng hoặc sẽ chỉ thay đổi nó theo những cách an toàn và không có thể xem xét, không cần quan tâm đến loại con trỏ nào họ nhận được.
Để biết tỷ lệ kèo bóng đá tối nay ví dụ về làm việc với tỷ lệ kèo bóng đá tối nay 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.
Nếu bạn thấy bất cứ điều gì trong tài liệu không chính tỷ lệ kèo bóng đá tối nay, không khớpMẫu nàyĐể báo cáo vấn đề tài liệu.