Returns a palloc'd array of keys given an item to be indexed. 반환된 키의 수는 다음 위치에 저장되어야 합니다.*nkeys. 키 중 하나라도 null이 될 수 있으면 다음 배열도 palloc에 추가합니다.*nkeys 부울필드, 주소를 다음 위치에 저장하세요.*nullFlags, 필요에 따라 이러한 null 플래그를 설정사설 토토.*nullFlags남길 수 있음NULL18017_18090NULL항목에 열쇠가 포함되어 있지 않은 경우.

쿼리할 값이 주어지면 palloc'd 키 배열을 반환사설 토토. 즉,질의왼쪽이 인덱싱된 열인 인덱싱 가능한 연산자의 오른쪽 값입니다.n은 연산자 클래스 내 연산자의 전략 번호입니다(참조섹션 36.16.2). 종종,추출쿼리상담이 필요사설 토토n데이터 유형을 결정하기 위해질의및 키 값을 추출하는 데 사용해야 하는 방법입니다. 반환된 키의 수는 다음 위치에 저장되어야 합니다.*nkeys. 키 중 하나라도 null이 될 수 있는 경우, 또한 다음 배열을 palloc으로 지정합니다.*nkeys 부울필드, 해당 주소를에 저장하세요.*nullFlags, 필요에 따라 이러한 null 플래그를 설정사설 토토.*nullFlags남길 수 있음NULL19462_19535NULLif the질의키가 포함되어 있지 않습니다.

검색모드는 다음을 허용하는 출력 인수입니다.추출쿼리검색 수행 방법에 대한 세부정보를 지정합니다. 만일*검색모드다음으로 설정됨GIN_SEAR사설 토토_MODE_DEFAULT(호출 전에 초기화되는 값), 반환된 키 중 적어도 하나와 일치하는 항목만 후보 일치로 간주됩니다. 만일*검색모드다음으로 설정됨GIN_SEAR사설 토토_MODE_INCLUDE_EMPTY, 그러면 일치하는 키가 하나 이상 포함된 항목 외에도 키가 전혀 포함되지 않은 항목도 후보 일치로 간주됩니다. (이 모드는 예를 들어 is-subset-of 연산자를 구현하는 데 유용합니다.) If*검색모드다음으로 설정됨GIN_SEAR사설 토토_MODE_ALL, 반환된 키와 일치하는지 여부에 관계없이 인덱스의 null이 아닌 모든 항목은 후보 일치로 간주됩니다. (이 모드는 본질적으로 전체 인덱스를 스캔해야 하기 때문에 다른 두 가지 선택보다 훨씬 느립니다. 그러나 코너 케이스를 올바르게 구현해야 할 수도 있습니다. 대부분의 경우 이 모드가 필요한 연산자는 아마도 GIN 연산자 클래스에 적합한 후보가 아닐 것입니다.) 이 모드를 설정하는 데 사용할 기호는 다음에 정의되어 있습니다.액세스/gin.h.

pmat사설 토토은 부분 일치가 지원될 때 사용되는 출력 인수입니다. 그것을 사용하려면,추출쿼리다음 배열을 할당해야 사설 토토*nkeys 부울s 그리고 주소를에 저장하세요.*pmat사설 토토. 해당 키에 부분 일치가 필요한 경우 배열의 각 요소를 true로 설정하고, 그렇지 않은 경우 false로 설정해야 사설 토토. 만일*pmat사설 토토다음으로 설정됨NULL그러면 GIN은 부분 일치가 필요하지 않다고 가정합니다. 변수는 다음과 같이 초기화됩니다.NULL호출하기 전에, 부분 일치를 지원하지 않는 연산자 클래스에서는 이 인수를 무시할 수 있습니다.

extra_data다음을 허용하는 출력 인수입니다.추출쿼리추가 데이터를 다음에 전달하기 위해일관됨그리고비교부분방법. 그것을 사용하려면,추출쿼리배열을 할당해야 사설 토토*nkeys포인터를 사용하고 주소를 다음 위치에 저장합니다.*extra_data, 그런 다음 원하는 것을 개별 포인터에 저장합니다. 변수는 다음과 같이 초기화됩니다.NULL호출하기 전에 추가 데이터가 필요하지 않은 연산자 클래스에서는 이 인수를 무시할 수 있습니다. 만일*extra_data이 설정되면 전체 배열이일관적인메서드 및 해당 요소비교부분방법.

색인된 항목이 쿼리 연산자의 전략 번호를 만족하면 참을 반환합니다.n(또는 재확인 표시가 반환되면 이를 만족할 수도 있음). 이 함수는 인덱싱된 항목의 값에 직접 액세스할 수 없습니다.진항목을 명시적으로 저장하지 않습니다. 오히려 쿼리에서 추출된 키 값이 특정 인덱싱된 항목에 나타나는지에 대한 정보가 이용 가능합니다.확인배열에 길이가 있음n키, 이는 이전에에서 반환된 키 수와 동일합니다.추출쿼리이것을 위해질의데이텀. 의 각 요소확인배열은 색인된 항목에 해당 쿼리 키가 포함된 경우 참입니다. 즉, (check[i] == true) i번째 키가추출쿼리결과 배열이 색인된 항목에 있습니다. 원본질의다음의 경우 데이터가 전달됩니다.일관적인방법은 이를 참조해야 하며, 그도 마찬가지입니다쿼리키[]그리고nullFlags[]이전에 반환한 배열추출쿼리. extra_datais the extra-data array returned by추출쿼리또는NULL없으면.

언제추출쿼리null 키를 반환사설 토토.쿼리키[], 해당확인[]element is true if the indexed item contains a null key; 즉, 의미론은확인[]같습니다다음과 다르지 않습니다.일관됨함수는 해당하는 것을 검사할 수 있습니다nullFlags[]일반 값 일치와 null 일치 간의 차이를 알려야 하는 경우 요소입니다.

성공하면,*다시 확인힙 튜플을 쿼리 연산자에 대해 다시 확인해야 하는 경우 true로 설정해야 하고, 인덱스 테스트가 정확하면 false로 설정해야 합니다. 즉, 잘못된 반환 값은 힙 튜플이 쿼리와 일치하지 않음을 보장합니다. 를 사용한 실제 반환 값*다시 확인false로 설정하면 힙 튜플이 쿼리와 일치함을 보장합니다. 그리고 다음의 실제 반환 값은*다시 확인true로 설정하면 힙 튜플이 쿼리와 일치할 수 있으므로 원래 인덱싱된 항목에 대해 쿼리 연산자를 직접 평가하여 가져오고 다시 확인해야 함을 의미합니다.

트리일관성다음과 유사함일관적인, 그러나의 부울 대신확인벡터, 각 키에 대해 세 가지 가능한 값이 있습니다:GIN_TRUE, GIN_FALSE그리고GIN_MAYBE. GIN_FALSE그리고GIN_TRUE일반 부울 값과 동일한 의미를 갖는 반면GIN_MAYBE은 해당 키의 존재를 알 수 없음을 의미합니다. 언제GIN_MAYBE값이 존재사설 토토. 함수는 반환만 해야 사설 토토.GIN_TRUE인덱스 항목에 해당 쿼리 키가 포함되어 있는지 여부와 항목이 확실히 일치하는 경우. 마찬가지로 함수는 다음을 반환해야 합니다.GIN_FALSE항목이 확실히 일치하지 않는 경우에만 해당 항목의 포함 여부에 관계없이GIN_MAYBE키. 결과가 다음에 따라 달라지는 경우GIN_MAYBE항목, 즉 알려진 쿼리 키를 기반으로 일치를 확인하거나 반박할 수 없으며 함수는 반환해야 합니다.GIN_MAYBE.

없을 때GIN_MAYBE값확인벡터, aGIN_MAYBE반환 값은 다음을 설정하는 것과 동일합니다.다시 확인부울 플래그일관적인함수.

두 개의 키(인덱싱된 항목 아님!)를 비교하고 0보다 작은 정수, 0 또는 0보다 큰 정수를 반환하여 첫 번째 키가 두 번째 키보다 작거나 같은지 또는 큰지를 나타냅니다. Null 키는 이 함수에 전달되지 않습니다.

부분 일치 쿼리 키를 인덱스 키와 비교하십시오. 결과를 나타내는 부호가 있는 정수를 반환합니다. 0보다 작으면 인덱스 키가 쿼리와 일치하지 않지만 인덱스 스캔은 계속되어야 함을 의미합니다. 0은 인덱스 키가 쿼리와 일치함을 의미합니다. 0보다 크면 더 이상 일치하는 항목이 없기 때문에 인덱스 스캔이 중지되어야 함을 나타냅니다. 전략 번호n30141_30286extra_data는 다음에 의해 만들어진 추가 데이터 배열의 해당 요소입니다.추출쿼리, 또는NULL없으면. Null 키는 이 함수에 전달되지 않습니다.

연산자 클래스 동작을 제어하는 사용자가 볼 수 있는 매개변수 세트를 정의합니다.

그옵션함수는 a에 대한 포인터를 전달받습니다.local_reloptsstruct, 연산자 클래스별 옵션 세트로 채워져야 합니다. 옵션은를 사용하여 다른 지원 기능에서 액세스할 수 있습니다.PG_HAS_OPCLASS_OPTIONS()그리고PG_GET_OPCLASS_OPTIONS()매크로.

인덱싱된 값의 키 추출과 키의 표현이 모두 포함되어 있으므로진유연하며 사용자가 지정한 매개변수에 따라 달라질 수 있습니다.

a에 삽입진각 항목에 대해 많은 키가 삽입될 가능성으로 인해 색인이 느려질 수 있습니다. 따라서 테이블에 대량 삽입하려면 GIN 인덱스를 삭제하고 대량 삽입을 마친 후 다시 생성하는 것이 좋습니다.

언제빠른 업데이트다음에 대해 활성화되었습니다.진(참조섹션 64.4.4.1자세한 내용은) 그렇지 않은 경우보다 페널티가 적습니다. 그러나 대규모 업데이트의 경우에는 색인을 삭제하고 다시 생성하는 것이 여전히 가장 좋습니다.

a의 빌드 시간진색인은 다음에 매우 민감합니다.maintenance_work_mem설정; 인덱스 생성 중에 작업 메모리를 인색하는 것은 비용이 들지 않습니다.

기존 항목에 일련의 삽입 중진다음을 가진 색인빠른 업데이트활성화되면 시스템은 목록이 다음보다 커질 때마다 보류 항목 목록을 정리합니다.gin_pending_list_limit. 관찰된 응답 시간의 변동을 방지하려면 보류 목록 정리가 백그라운드에서(즉, autovacuum을 통해) 발생하도록 하는 것이 바람직사설 토토. 증가하면 전경 정리 작업을 피할 수 있습니다.gin_pending_list_limit또는 autovacuum을 더욱 공격적으로 만듭니다. 그러나 정리 작업의 임계값을 늘리면 전경 정리가 발생하면 시간이 더 오래 걸립니다.

gin_pending_list_limit저장 매개변수를 변경하여 개별 GIN 인덱스에 대해 재정의할 수 있으며, 이를 통해 각 GIN 인덱스는 자체 정리 임계값을 가질 수 있습니다. 예를 들어, 크게 업데이트될 수 있는 GIN 인덱스에 대해서만 임계값을 늘리고 그렇지 않은 경우에는 임계값을 줄이는 것이 가능합니다.

개발의 주요 목표진indexes was to create support for highly scalable full-text sear사설 토토 in포스트그레SQL, 전체 텍스트 검색에서 매우 많은 양의 결과가 반환되는 경우가 종종 있습니다. 더욱이 이는 쿼리에 매우 자주 사용되는 단어가 포함되어 있어 큰 결과 집합이 유용하지 않을 때 자주 발생사설 토토. 디스크에서 많은 튜플을 읽고 정렬하는 데 많은 시간이 걸릴 수 있으므로 이는 프로덕션에서는 허용되지 않습니다. (인덱스 검색 자체는 매우 빠릅니다.)

그러한 쿼리의 제어된 실행을 용이하게 하기 위해,진반환된 행 수에 대해 구성 가능한 소프트 상한이 있습니다.gin_fuzzy_sear사설 토토_limit구성 매개변수. 기본적으로 0(제한 없음을 의미)으로 설정됩니다. If a non-zero limit is set, then the returned set is a subset of the whole result set, 사설 토토osen at random.

“소프트”반환된 결과의 실제 개수는 쿼리 및 시스템 난수 생성기의 품질에 따라 지정된 제한과 다소 다를 수 있음을 의미사설 토토.

경험상 수천 단위의 값(예: 5000 - 20000)이 잘 작동사설 토토.

여러 데이터 유형에 대한 B-트리 동등한 기능

(키, 값) 쌍을 저장하기 위한 모듈

향상된 지원정수[]

트라이그램 일치를 사용한 텍스트 유사성