Trả về một mảng palloc'd gồm các phím được cung cấp một kèo bóng đá pháp được lập chỉ kèo bóng đá pháp. Số lượng khóa trả về phải được lưu trữ thành*NKEYS. Nếu bất kỳ phím nào có thể là null, cũng palloc một mảng*NKEYS boolTrường, lưu trữ địa chỉ của nó tại*nullflags, và đặt kèo bóng đá pháp cờ null này khi cần thiết.*nullflagscó thể để lạinull(giá trị ban đầu của nó) nếu tất cả kèo bóng đá pháp khóa không phải là null. Giá trị trả về có thể lànullNếu kèo bóng đá pháp không chứa khóa.

Trả về một mảng palloc'd gồm kèo bóng đá pháp khóa được cung cấp một giá trị được truy vấn; đó là,Truy vấnlà giá trị ở phía bên phải của toán tử có thể lập chỉ kèo bóng đá pháp có phía bên trái là cột được lập chỉ kèo bóng đá pháp.nlà số chiến lược của toán tử trong lớp toán tử (xemPhần 36.16.2). Thường,Trích xuấtSẽ cần tham khảo ý kiếnnĐể xác định loại dữ liệu củaTruy vấnvà phương pháp nó nên sử dụng để trích xuất kèo bóng đá pháp giá trị khóa. Số lượng khóa trả về phải được lưu trữ thành*NKEYS. Nếu bất kỳ phím nào có thể là null, cũng palloc một mảng*NKEYS BoolTrường, lưu trữ địa chỉ của nó tại*nullflags, và đặt kèo bóng đá pháp cờ null này khi cần thiết.*nullflagscó thể để lạinull(giá trị ban đầu của nó) nếu tất cả kèo bóng đá pháp khóa không phải là null. Giá trị trả về có thể lànullNếuTruy vấnkhông chứa khóa.

SearchModelà đối số đầu ra cho phépTrích xuấtĐể chỉ định chi tiết về cách tìm kiếm sẽ được thực hiện. Nếu như*SearchModeđược đặt thànhGin_Search_Mode_Default(là giá trị mà nó được khởi tạo trước khi gọi), chỉ các kèo bóng đá pháp phù hợp với ít nhất một trong các khóa trả về được coi là phù hợp ứng cử viên. Nếu như*SearchModeđược đặt thànhGIN_SEARCH_MODE_INCLUDE_EMPTY, sau đó ngoài các kèo bóng đá pháp chứa ít nhất một phím phù hợp, các kèo bóng đá pháp không chứa khóa nào được coi là phù hợp ứng cử viên. (Ví dụ: Chế độ này rất hữu ích để triển khai các toán tử là bộ phận của các toán tử.) Nếu*SearchModeđược đặt thànhGIN_SEARCH_MODE_ALL, thì tất cả các kèo bóng đá pháp không null trong chỉ kèo bóng đá pháp được coi là phù hợp với ứng cử viên, cho dù chúng có khớp với bất kỳ khóa nào được trả về hay không. .access/kèo bóng đá pháph.

pmatchlà một đối số đầu ra để sử dụng khi hỗ trợ kết hợp một phần. Để sử dụng nó,Trích xuấtPhải phân bổ một mảng*NKEYS boolS và lưu trữ địa chỉ của nó tại*pmatch. Mỗi phần tử của mảng phải được đặt thành true nếu khóa tương ứng yêu cầu khớp một phần, sai nếu không.*pmatchđược đặt thànhnullSau đó, kèo bóng đá pháp giả định rằng không cần kết hợp một phần. Biến được khởi tạo thànhNULLTrước khi gọi, vì vậy đối số này có thể bị bỏ qua bởi kèo bóng đá pháp lớp toán tử không hỗ trợ khớp một phần.

Extra_Datalà đối số đầu ra cho phépTrích xuấtĐể truyền dữ liệu bổ sung chonhất quánvàSo sánhpartialPhương kèo bóng đá pháp. Để sử dụng nó,Trích xuấtPhải phân bổ một mảng*NKEYSCon trỏ và lưu trữ địa chỉ của nó tại*Extra_data, sau đó lưu trữ bất cứ điều gì nó muốn vào kèo bóng đá pháp con trỏ riêng lẻ. Biến được khởi tạo thànhnullTrước khi gọi, vì vậy đối số này có thể đơn giản bị bỏ qua bởi kèo bóng đá pháp lớp toán tử không yêu cầu thêm dữ liệu. Nếu như*Extra_datađược đặt, toàn bộ mảng được chuyển chonhất quánPhương kèo bóng đá pháp và phần tử thích hợp choso sánhspartialPhương kèo bóng đá pháp.

Trả về đúng nếu một kèo bóng đá pháp được lập chỉ kèo bóng đá pháp thỏa mãn toán tử truy vấn với số chiến lượcn(hoặc có thể thỏa mãn nó, nếu chỉ báo kiểm tra lại). Chức năng này không có quyền truy cập trực tiếp vào giá trị của kèo bóng đá pháp được lập chỉ kèo bóng đá pháp, vìkèo bóng đá phápKhông lưu trữ các kèo bóng đá pháp một cách rõ ràng. Thay vào đó, những gì có sẵn là kiến ​​thức về giá trị khóa nào được trích xuất từ ​​truy vấn xuất hiện trong một kèo bóng đá pháp được lập chỉ kèo bóng đá pháp nhất định.Kiểm tramảng có độ dàiNKEYS, giống như số lượng khóa được trả về trước đóTrích xuấtcho điều nàyTruy vấnDatum. Mỗi yếu tố củaKiểm traMảng là đúng nếu kèo bóng đá pháp được lập chỉ kèo bóng đá pháp chứa khóa truy vấn tương ứng, tức là, nếu (kiểm tra [i] == true) phím thứ i củaTrích xuấtMảng kết quả có mặt trong kèo bóng đá pháp được lập chỉ kèo bóng đá pháp. Bản gốcTruy vấnDatum được truyền trong trường hợpnhất quánPhương kèo bóng đá pháp cần tham khảo nó, và cũng vậyQuerykeys []vànullflags []mảng được trả về trước đóTrích xuất. Extra_Datalà mảng dữ liệu thêm được trả về bởiTrích xuấthoặcnullNếu không.

KhiTrích xuấtTrả về phím null trongTruy vấn [], tương ứngKiểm tra []Phần tử là đúng nếu kèo bóng đá pháp được lập chỉ kèo bóng đá pháp chứa khóa null; đó là ngữ nghĩa củaKiểm tra []giống nhưkhông khác biệt với. Thenhất quánHàm có thể kiểm tra tương ứngnullflags []Phần tử nếu nó cần cho biết sự khác biệt giữa phù hợp giá trị thông thường và khớp null.

Khi thành công,*Rechecknên được đặt thành true nếu tple heap cần được kiểm tra lại đối với toán tử truy vấn hoặc sai nếu kiểm tra chỉ kèo bóng đá pháp là chính xác. Đó là, một giá trị trả về sai đảm bảo rằng Tuple Heap không khớp với truy vấn;*RecheckĐặt thành Sai đảm bảo rằng Tuple Heap không khớp với truy vấn; và giá trị trả về thực sự với*Recheck26583_26765

Triconsistentgiống vớinhất quán, nhưng thay vì booleans trongKiểm traVector, có ba giá trị có thể cho mỗi khóa:gin_true, gin_falsevàgin_maybe. gin_falsevàgin_trueCó ý nghĩa tương tự như kèo bóng đá pháp giá trị boolean thông thường, trong khiGin_Maybecó nghĩa là sự hiện diện của khóa đó không được biết đến. Khigin_maybeGiá trị có mặt, hàm chỉ nên trả vềgin_trueNếu kèo bóng đá pháp chắc chắn khớp với việc kèo bóng đá pháp chỉ kèo bóng đá pháp có chứa các khóa truy vấn tương ứng hay không. Tương tự như vậy, hàm phải trả vềgin_falseChỉ khi vật phẩm chắc chắn không khớp, dù nó có chứaGin_MaybeKhóa. Nếu kết quả phụ thuộc vàogin_maybekèo bóng đá pháp nhập, tức là, trận đấu không thể được xác nhận hoặc bác bỏ dựa trên các khóa truy vấn đã biết, chức năng phải trả vềgin_maybe.

Khi không cóGin_MaybeGiá trị trongKiểm traVector, Agin_maybeGiá trị trả về tương đương với việc cài đặtRecheckcờ trong booleannhất quánchức năng.

So sánh hai khóa (không được lập chỉ kèo bóng đá pháp!) Và trả về một số nguyên nhỏ hơn 0, 0 hoặc lớn hơn 0, cho biết phím thứ nhất có nhỏ hơn hoặc bằng hoặc lớn hơn thứ hai hay không. Các phím null không bao giờ được truyền cho chức năng này.

So sánh khóa truy vấn khớp một phần với khóa chỉ kèo bóng đá pháp. Trả về một số nguyên có dấu cho biết kết quả: nhỏ hơn 0 có nghĩa là khóa chỉ kèo bóng đá pháp không khớp với truy vấn, nhưng việc quét chỉ kèo bóng đá pháp sẽ tiếp tục;ncủa toán tử tạo truy vấn khớp một phần được cung cấp, trong trường hợp ngữ nghĩa của nó là cần thiết để xác định thời điểm kết thúc quét. Cũng,Extra_Datalà phần tử tương ứng của mảng dữ liệu phụ được thực hiện bởiTrích xuấthoặcnullNếu không có. kèo bóng đá pháp phím null không bao giờ được truyền cho chức năng này.

Xác định một tập hợp kèo bóng đá pháp tham số có thể nhìn thấy người dùng có thể điều khiển hành vi của lớp toán tử.

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

Vì cả hai trích xuất chính của các giá trị được lập chỉ kèo bóng đá pháp và biểu diễn của khóa trongkèo bóng đá pháplinh hoạt, chúng có thể phụ thuộc vào kèo bóng đá pháp tham số do người dùng chỉ định.

Chèn vào Akèo bóng đá phápChỉ kèo bóng đá pháp có thể chậm do khả năng nhiều khóa được chèn cho mỗi kèo bóng đá pháp. Vì vậy, đối với các chèn số lượng lớn vào một bảng, nên bỏ chỉ số gin và tạo lại nó sau khi hoàn thành việc chèn số lượng lớn.

KhiFastupDateđược bật chokèo bóng đá pháp(xemPhần 65.4.4.1Để biết chi tiết), hình phạt nhỏ hơn khi nó không. Nhưng đối với các bản cập nhật rất lớn, nó vẫn có thể tốt nhất để bỏ và tạo lại chỉ kèo bóng đá pháp.

Xây dựng thời gian cho Akèo bóng đá phápChỉ kèo bóng đá pháp rất nhạy cảm vớibảo trì_work_memCài đặt; nó không trả tiền để tiết kiệm bộ nhớ làm việc trong quá trình tạo chỉ kèo bóng đá pháp.

Trong một loạt kèo bóng đá pháp phần chèn vào hiện tạikèo bóng đá phápINDEX cóFastupdateĐã bật, hệ thống sẽ dọn dẹp danh sách nhập cảnh đang chờ xử lý bất cứ khi nào danh sách phát triển lớn hơngin_pending_list_limit. Để tránh sự biến động trong thời gian phản hồi quan sát, mong muốn được làm sạch trong danh sách đang chờ xử lý xảy ra trong nền (tức là, thông qua Autovacuum).gin_pending_list_limithoặc làm cho Autovacuum trở nên tích cực hơn. Tuy nhiên, việc mở rộng ngưỡng của hoạt động dọn dẹp có nghĩa là nếu việc dọn dẹp tiền cảnh xảy ra, nó sẽ mất nhiều thời gian hơn.

gin_pending_list_limitcó thể được ghi đè cho các chỉ kèo bóng đá pháp GIN riêng lẻ bằng cách thay đổi các tham số lưu trữ, cho phép mỗi chỉ kèo bóng đá pháp GIN có ngưỡng làm sạch riêng. Ví dụ: chỉ có thể tăng ngưỡng cho chỉ số gin có thể được cập nhật rất nhiều và giảm nó.

kèo bóng đá pháp tiêu chính của việc phát triểnkèo bóng đá phápIndexes là để tạo hỗ trợ cho tìm kiếm văn bản đầy đủ có thể mở rộng trongPostgreSQLvà thường có kèo bóng đá pháp tình huống khi một tìm kiếm toàn văn lại trả về một tập hợp kết quả rất lớn. Hơn nữa, điều này thường xảy ra khi truy vấn chứa kèo bóng đá pháp từ rất thường xuyên, do đó tập kết quả lớn thậm chí không hữu ích.

Để tạo điều kiện thực hiện có kiểm soát kèo bóng đá pháp truy vấn đó,kèo bóng đá phápcó giới hạn trên mềm có thể định cấu hình trên số lượng hàng được trả về: Thegin_fuzzy_search_limitTham số cấu hình. Nó được đặt thành 0 (có nghĩa là không có giới hạn) theo mặc định.

MạnhSoftcó nghĩa là số lượng kết quả trả về thực tế có thể khác với giới hạn được chỉ định, tùy thuộc vào truy vấn và chất lượng của bộ tạo số ngẫu nhiên của hệ thống.

Từ kinh nghiệm, kèo bóng đá pháp giá trị trong hàng ngàn (ví dụ: 5000 - 20000) hoạt động tốt.

Chức năng tương đương B-cây cho một số loại dữ liệu

Mô -đun để lưu trữ (khóa, giá trị) cặp

Hỗ trợ nâng cao choint []

Sự tương đồng về văn bản bằng cách sử dụng Trigram khớp