Đã cho cách đọc kèo bóng đá nhập chỉ cách đọc kèo bóng đáPvà giá trị truy vấnq, Hàm này xác định xem cách đọc kèo bóng đá nhập chỉ cách đọc kèo bóng đá lànhất quánHồivới truy vấn; nghĩa là, có thể là vị ngữinstioned_column Indexable_operator qHồiTrue cho bất kỳ hàng nào được biểu thị bằng cách đọc kèo bóng đá nhập chỉ cách đọc kèo bóng đá? Đối với một cách đọc kèo bóng đá nhập chỉ số lá, điều này tương đương với việc kiểm tra điều kiện có thể lập chỉ cách đọc kèo bóng đá, trong khi đối với một nút cây bên trong, bạn có cần thiết phải quét cây con của chỉ số được biểu thị bằng nút cây hay không.TRUE, ARecheckCờ cũng phải được trả về. Điều này cho biết cách đọc kèo bóng đá vị ngữ chắc chắn là đúng hay chỉ có thể đúng.RECHECK=SaiSau đó, chỉ cách đọc kèo bóng đá đã kiểm tra chính xác điều kiện vị ngữ, trong khi nếuRECHECK=TRUEHàng chỉ là một trận đấu ứng cử viên. Trong trường hợp đó, hệ thống sẽ tự động đánh giáIndexable_operatorso với giá trị hàng thực tế để xem nó có thực sự là một trận đấu hay không. Quy ước này cho phépGistĐể hỗ trợ cả cấu trúc chỉ số không mất và mất.

TheSQLTuyên bố chức cách đọc kèo bóng đá phải trông như thế này:

Tạo hoặc thay thế hàm my_consistent (nội bộ, data_type, smallint, oid, nội bộ)

và mã phù hợp trong mô -đun C sau đó có thể theo dõi bộ xương này:

pg_function_info_v1 (my_consistent);

ở đây,Keylà một yếu tố trong chỉ cách đọc kèo bóng đá vàTruy vấnGiá trị được tra cứu trong chỉ cách đọc kèo bóng đá. TheStrategyNumberTham số cho biết toán tử nào cách đọc kèo bóng đá lớp toán tử cách đọc kèo bóng đá bạn đang được áp dụng - Nó phù hợp với một trong các số toán tử trongTạo lớp toán tửlệnh.

Tùy thuộc vào toán tử bạn đã đưa vào lớp, kiểu dữ cách đọc kèo bóng đá củaTruy vấncó thể thay đổi theo toán tử, vì nó sẽ là bất kỳ loại nào ở phía bên phải của toán tử, có thể khác với loại dữ liệu được lập chỉ cách đọc kèo bóng đá xuất hiện ở phía bên trái. (Bộ xương mã trên giả định rằng chỉ có một loại có thể; nếu không, tìm nạpTruy vấnGiá trị đối số sẽ phải phụ thuộc vào toán tử.)nhất quánHàm sử dụng kiểu dữ liệu được lập chỉ cách đọc kèo bóng đá của OPClass choTruy vấnĐối số, mặc dù loại thực tế có thể là thứ khác tùy thuộc vào toán tử.

Phương pháp này củng cố thông tin trong cây. Cho một tập hợp các mục, chức cách đọc kèo bóng đá này tạo ra một mục chỉ mục mới đại diện cho tất cả các mục đã cho.

TheSQLTuyên bố chức cách đọc kèo bóng đá phải trông như thế này:

Tạo hoặc thay thế hàm my_union (nội bộ, nội bộ)

và mã phù hợp trong mô -đun C sau đó có thể theo bộ xương này:

pg_function_info_v1 (my_union);

Như bạn có thể thấy, trong bộ xương này, chúng tôi đang xử lý một kiểu dữ cách đọc kèo bóng đá trong đóUnion (X, Y, Z) = Union (Union (X, Y), Z). Nó đủ dễ dàng để hỗ trợ các loại dữ cách đọc kèo bóng đá trong đó đây không phải là trường hợp, bằng cách thực hiện thuật toán liên minh thích hợp trong nàyGistPhương pháp hỗ trợ.

Kết quả cách đọc kèo bóng đáUnionHàm phải là giá trị của loại lưu trữ của chỉ cách đọc kèo bóng đá, bất cứ điều gì (nó có thể hoặc không khác với loại cột được lập chỉ cách đọc kèo bóng đá). TheUnionHàm sẽ trả một con trỏ mớipalloc ()Bộ nhớ ED. Bạn không thể trả về giá trị đầu vào as-is, ngay cả khi không có loại thay đổi.

Như được hiển thị ở trên,UnionFirst FirstNội bộĐối số thực sự là mộtgistEntryVectorCon trỏ. Đối số thứ hai là một con trỏ tới một biến số nguyên, có thể bị bỏ qua.UnionHàm lưu trữ kích thước cách đọc kèo bóng đá giá trị kết quả cách đọc kèo bóng đá nó vào biến đó, nhưng điều này không còn cần thiết nữa.)

Chuyển đổi một cách đọc kèo bóng đá dữ liệu thành một định dạng phù hợp để lưu trữ vật lý trong một trang chỉ cách đọc kèo bóng đá. NếunénPhương thức bị bỏ qua, các cách đọc kèo bóng đá dữ liệu được lưu trữ trong chỉ cách đọc kèo bóng đá mà không cần sửa đổi.

TheSQLTuyên bố chức cách đọc kèo bóng đá phải trông như thế này:

Tạo hoặc thay thế hàm my_compress (nội bộ)

và mã phù hợp trong mô -đun C sau đó có thể theo dõi bộ xương này:

pg_function_info_v1 (my_compress);

Bạn phải điều chỉnhnén_data_typesang loại cụ thể mà bạn đang chuyển đổi để nén các nút lá cách đọc kèo bóng đá bạn, tất nhiên.

Chuyển đổi biểu diễn được lưu trữ của một cách đọc kèo bóng đá dữ liệu thành một định dạng có thể được thao tác bởi các phương thức GIST khác trong lớp toán tử. Nếugiải nénPhương pháp bị bỏ qua, giả sử rằng các phương thức chính khác có thể hoạt động trực tiếp trên định dạng dữ cách đọc kèo bóng đá được lưu trữ. (giải nénkhông nhất thiết là mặt trái cách đọc kèo bóng đánénPhương pháp; Cụ thể, nếunénlà mất thì không thể chogiải nénĐể xây dựng lại chính xác dữ cách đọc kèo bóng đá gốc.giải nénkhông nhất thiết phải tương đương vớiFetch, vì các phương thức định chính khác có thể không yêu cầu tái cấu trúc dữ cách đọc kèo bóng đá đầy đủ.)

TheSQLTuyên bố chức cách đọc kèo bóng đá phải trông như thế này:

Tạo hoặc thay thế hàm my_decompress (nội bộ)

Và mã phù hợp trong mô -đun C sau đó có thể theo dõi bộ xương này:

pg_function_info_v1 (my_decompress);

Bộ xương trên phù hợp cho trường hợp không cần giải nén. (Nhưng, tất nhiên, việc bỏ qua phương pháp hoàn toàn thậm chí còn dễ dàng hơn và được khuyến nghị trong những trường hợp như vậy.)

Trả về giá trị biểu thịchi phícủa việc chèn cách đọc kèo bóng đá mới vào một nhánh cụ thể của cây. Các cách đọc kèo bóng đá sẽ được chèn xuống đường dẫn ít nhấthình phạtTrong cây. Giá trị được trả về bởihình phạtnên không âm. Nếu một giá trị âm được trả về, nó sẽ được coi là 0.

TheSQLTuyên bố chức cách đọc kèo bóng đá phải trông như thế này:

Tạo hoặc thay thế hàm my_penalty (nội bộ, nội bộ, nội bộ)

Và mã phù hợp trong mô -đun C sau đó có thể tuân theo bộ xương này:

pg_function_info_v1 (my_penalty);

Vì lý do lịch sử,hình phạthàm không chỉ trả vềFloatKết quả; Thay vào đó, nó phải lưu trữ giá trị tại vị trí được biểu thị bằng đối số thứ ba.

Thehình phạtHàm rất quan trọng đối với hiệu suất tốt của chỉ cách đọc kèo bóng đá. Nó sẽ được sử dụng vào thời gian chèn để xác định chi nhánh nào sẽ làm theo khi chọn nơi thêm cách đọc kèo bóng đá nhập mới vào cây.

Khi cần phân chia trang chỉ mục, chức cách đọc kèo bóng đá này quyết định mục nhập nào trên trang sẽ ở trên trang cũ và sẽ chuyển sang trang mới.

TheSQLTuyên bố chức cách đọc kèo bóng đá phải trông như thế này:

Tạo hoặc thay thế hàm my_picksplit (nội bộ, nội bộ)

Và mã phù hợp trong mô -đun C sau đó có thể theo dõi bộ xương này:

pg_function_info_v1 (my_picksplit);

Lưu ý rằngpicksplitKết quả của chức cách đọc kèo bóng đá được phân phối bằng cách sửa đổi thông quaVCấu trúc. Giá trị trả về mỗi se bị bỏ qua, mặc dù thông thường để truyền lại địa chỉ cách đọc kèo bóng đáV.

nhưhình phạt, ThePickSplitHàm rất quan trọng đối với hiệu suất tốt của chỉ cách đọc kèo bóng đá. Thiết kế phù hợphình phạtvàPickSplittriển khai là nơi thách thức thực hiện biểu diễn tốtGistLIES LIES.

Trả về đúng nếu hai cách đọc kèo bóng đá chỉ cách đọc kèo bóng đá giống hệt nhau, sai. (MỘTMạnhcách đọc kèo bóng đá nhập chỉ cách đọc kèo bóng đálà giá trị của loại lưu trữ của chỉ cách đọc kèo bóng đá, không nhất thiết là loại cột được lập chỉ cách đọc kèo bóng đá gốc.)

TheSQLTuyên bố chức cách đọc kèo bóng đá phải trông như thế này:

Tạo hoặc thay thế hàm my_same (Storage_Type, Storage_Type, Internal)

Và mã phù hợp trong mô -đun C sau đó có thể theo bộ xương này:

pg_function_info_v1 (my_same);

Vì lý do lịch sử,cùngHàm không chỉ trả về kết quả boolean; Thay vào đó, nó phải lưu trữ cờ tại vị trí được biểu thị bằng đối số thứ ba.

Cho cách đọc kèo bóng đá nhập chỉ cách đọc kèo bóng đáPvà giá trị truy vấnQ, Hàm này xác định cách đọc kèo bóng đá nhập của cách đọc kèo bóng đá nhậpHồiKhoảng cáchKhănTừ giá trị truy vấn. Hàm này phải được cung cấp nếu lớp toán tử chứa bất kỳ toán tử đặt hàng nào.Khoảng cáchHồiĐầu tiên, vì vậy các kết quả phải phù hợp với ngữ nghĩa của nhà điều hành. Đối với cách đọc kèo bóng đá nhập chỉ số lá, kết quả chỉ thể hiện khoảng cách đến cách đọc kèo bóng đá nhập chỉ cách đọc kèo bóng đá;

TheSQLTuyên bố chức cách đọc kèo bóng đá phải trông như thế này:

Tạo hoặc thay thế hàm my_distance (nội bộ, data_type, smallint, oid, nội bộ)

và mã phù hợp trong mô -đun C sau đó có thể theo dõi bộ xương này:

pg_function_info_v1 (my_distance);

cách đọc kèo bóng đá đối số choKhoảng cáchHàm giống hệt với các đối số cách đọc kèo bóng đánhất quánchức cách đọc kèo bóng đá.

Một số xấp xỉ được cho phép khi xác định khoảng cách, miễn là kết quả không bao giờ lớn hơn khoảng cách thực tế của cách đọc kèo bóng đá. Do đó, ví dụ, khoảng cách đến một hộp giới hạn thường là đủ trong các ứng dụng hình học.*Recheckđể đúng. .

Nếu hàm khoảng cách trả về*Rebheck = trueĐối với bất kỳ nút lá nào, loại trả về cách đọc kèo bóng đá toán tử đặt hàng ban đầu phải làfloat8hoặcfloat4và các giá trị kết quả của hàm khoảng cách phải tương đương với các giá trị của toán tử đặt hàng ban đầu, vì người thực thi sẽ sắp xếp bằng cả kết quả chức cách đọc kèo bóng đá khoảng cách và kết quả điều hành đơn hàng được tính toán lại. Nếu không, các giá trị kết quả của hàm khoảng cách có thể là bất kỳ hữu hạnfloat8Giá trị, miễn là thứ tự tương đối cách đọc kèo bóng đá các giá trị kết quả khớp với thứ tự được trả về bởi toán tử đặt hàng. (Vô cực và trừ vô cực được sử dụng bên trong để xử lý các trường hợp như nulls, do đóKhoảng cáchHàm trả về cách đọc kèo bóng đá giá trị này.)

Chuyển đổi biểu diễn chỉ cách đọc kèo bóng đá nén của cách đọc kèo bóng đá dữ liệu thành kiểu dữ liệu gốc, để quét chỉ có chỉ cách đọc kèo bóng đá. Dữ liệu được trả về phải là một bản sao chính xác, không bị mất của giá trị được lập chỉ cách đọc kèo bóng đá ban đầu.

TheSQLTuyên bố chức cách đọc kèo bóng đá phải trông như thế này:

Tạo hoặc thay thế hàm my_fetch (nội bộ)

Đối số là một con trỏ tớigistEntryCấu trúc. Khi nhập cảnh, nóKeyTrường chứa một mốc dữ cách đọc kèo bóng đá lá không null ở dạng nén. Giá trị trả về là một giá trị khácgistEntrystruct, cóKeyTrường chứa cùng một mốc trong dạng ban đầu, không nén. Nếu chức cách đọc kèo bóng đá nén của OPClass không làm gì cho các mục lá, thìFetchPhương thức có thể trả về đối số as-is. Hoặc, nếu opclass không có chức cách đọc kèo bóng đá nén,FetchPhương pháp cũng có thể được bỏ qua, vì nó nhất thiết phải là không có op.

Mã phù hợp trong mô -đun C sau đó có thể tuân theo bộ xương này:

pg_function_info_v1 (my_fetch);

Nếu phương thức nén bị mất cho các cách đọc kèo bóng đá nhập lá, lớp toán tử không thể hỗ trợ các lần quét chỉ có chỉ cách đọc kèo bóng đá và không được xác địnhFetchchức cách đọc kèo bóng đá.

Cho phép định nghĩa các tham số có thể nhìn thấy người dùng có thể điều khiển hành vi cách đọc kèo bóng đá lớp toán tử.

TheSQLTuyên bố chức cách đọc kèo bóng đá phải trông như thế này:

Tạo hoặc thay thế hàm my_options (nội bộ)

Hàm được chuyển một con trỏ đến Alocal_reloptsstruct, cần được lấp đầy với một tập hợp các tùy chọn cụ thể của lớp vận hành. Các tùy chọn có thể được truy cập từ các chức cách đọc kèo bóng đá hỗ trợ khác bằng cách sử dụngPG_HAS_OPCLASS_OPTES ()vàPG_GET_OPCLASS_OPTES ()Macros.

Một ví dụ triển khai my_options () và các tham số sử dụng từ các chức cách đọc kèo bóng đá hỗ trợ khác được đưa ra dưới đây:

typedef enum myenumtype

Kể từ khi biểu diễn khóa trongGistlà linh hoạt, nó có thể phụ thuộc vào các tham số do người dùng chỉ định. Ví dụ, độ dài cách đọc kèo bóng đá chữ ký khóa có thể được chỉ định.gtsVector_options ()Ví dụ.

Trả về hàm so sánh để sắp xếp dữ cách đọc kèo bóng đá theo cách bảo tồn địa phương. Nó được sử dụng bởiTạo chỉ cách đọc kèo bóng đávàReindexlệnh. Chất lượng của chỉ cách đọc kèo bóng đá được tạo phụ thuộc vào mức độ sắp xếp được xác định bởi hàm so sánh bảo tồn địa phương của các đầu vào.

TheSortsupportPhương pháp là tùy chọn. Nếu nó không được cung cấp,Tạo chỉ cách đọc kèo bóng đáXây dựng chỉ cách đọc kèo bóng đá bằng cách chèn mỗi tuple vào cây bằng cách sử dụnghình phạtvàpicksplitChức cách đọc kèo bóng đá, chậm hơn nhiều.

TheSQLTuyên bố chức cách đọc kèo bóng đá phải trông như thế này:

Tạo hoặc thay thế hàm my_sortsupport (nội bộ)

Đối số là một con trỏ tớiSortsupportCấu trúc. Ở mức tối thiểu, chức cách đọc kèo bóng đá phải điền vào trường so sánh của nó.SortsupportCấu trúc. Các mốc dữ liệu là hai giá trị được lập chỉ cách đọc kèo bóng đá trong định dạng mà chúng được lưu trữ trong chỉ cách đọc kèo bóng đá;nénPhương pháp. API đầy đủ được xác định trongSRC/bao gồm/Utils/Sortsupport.h.

Mã phù hợp trong mô -đun C sau đó có thể tuân theo bộ xương này:

pg_function_info_v1 (my_sortsupport);