접두사 및 노드 레이블 데이터 유형의 데이터 유형 OID를 포함하여 인덱스 구현에 대한 정적 정보를 반환합니다.

theSQL함수 선언은 다음과 같아야합니다.

함수 만들기 my_config (내부, 내부) 반환 void ...

첫 번째 인수는 A에 대한 포인터입니다SPGCONFIGINc 함수에 대한 입력 데이터를 포함하는 구조. 두 번째 인수는 A에 대한 포인터입니다.SPGCONFIGOUTC 구조물, 함수가 결과 데이터로 채워야합니다.

typedef struct spgconfigin

atttype;

접두사를 사용하지 않는 운영자 클래스의 경우PrefixTypevoidoid. 마찬가지로 노드 레이블을 사용하지 않는 운영자 클래스의 경우labelTypevoidoid. CanreturnData운영자 클래스가 원래 보관 된 인덱스 값을 재구성 할 수있는 경우 true를 설정해야합니다.LongValuesok만 맞아야합니다.atttype길이가 변하고 연산자 클래스는 반복 된 접미사를 통해 긴 값을 분할 할 수 있습니다 (참조섹션 64.3.4.1).

LeafType운영자 클래스에 의해 정의 된 인덱스 저장 유형과 일치해야합니다opckeyType카탈로그 항목. (opckeyType0이 될 수 있습니다. 스토리지 유형이 연산자 클래스의 입력 유형과 동일하다는 것을 암시합니다. 가장 일반적인 상황입니다.) 후진 호환성의 이유로config메소드가 설정 될 수 있습니다LeafType다른 값으로, 그 값이 사용될 것입니다. 그러나 이것은 롤 토토 내용이 카탈로그에서 잘못 식별되기 때문에 더 이상 사용되지 않습니다.LeafType비 초기화 (0); 그것은에서 파생 된 롤 토토 스토리지 유형을 의미하는 것으로 해석됩니다.opckeyType.

언제atttypeandLeafType다른 방법compress제공되어야합니다. 방법compressatttypetoLeafType.

새 값을 내부 튜플에 삽입하는 방법을 선택합니다.

theSQL함수 선언은 다음과 같아야합니다.

함수 만들기 my_choose (내부, 내부) 반환 void ...

첫 번째 인수는 A에 대한 포인터입니다Spgchooseinc 함수에 대한 입력 데이터를 포함하는 구조. 두 번째 인수는 A에 대한 포인터입니다.spgchooseoutC 구조물, 함수가 결과 데이터로 채워야합니다.

typedef struct spgchoosein

Datum원래의 데이텀입니다.SPGCONFIGIN.atttype롤 토토에 삽입 될 유형.LeafdatumSPGCONFIGOUT.LeafType유형은 처음에 메소드의 결과입니다compress적용Datummethod.compress제공됩니다.Datum그렇지 않으면.Leafdatum이면 트리의 낮은 수준에서 변경할 수 있습니다선택또는picksplit메소드 변경. 삽입 검색이 리프 페이지에 도달하면 현재 값Leafdatum새로 생성 된 잎 튜플에 저장 될 것입니다.레벨는 루트 레벨의 경우 0에서 시작하는 현재 튜플 레벨입니다.Allthesame전류 내부 튜플이 여러 동등한 노드를 포함하는 것으로 표시된 경우 참조 (참조섹션 64.3.4.3). hasprefix전류 내부 튜플에 접두사가 포함되어 있으면 참입니다. 그렇다면,PrefixDatum값입니다.nnodes내부 튜플에 포함 된 자식 노드의 수는Nodelabels라벨이없는 경우 라벨 값의 배열이거나 널

the선택함수는 새 값이 기존 자식 노드 중 하나와 일치하거나 새 하위 노드가 추가되어야한다는 것을 결정할 수 있거나 새 값이 튜플 접두사와 일치하지 않으므로 내부 튜플을 분할하여 덜 제한적인 접두사를 생성해야합니다..

새 값이 기존 자식 노드 중 하나와 일치하는 경우resulttypetoSPGMATCHNODE. 세트Noden노드 어레이의 해당 노드의 인덱스 (제로)까지. 세트levelAdd증분으로레벨해당 노드를 통해 내림차순으로 인해 발생하거나 연산자 클래스가 레벨을 사용하지 않으면 0으로 남겨 둡니다. 세트RestDatum동등한Leafdatum운영자 클래스가 한 레벨에서 다음 레벨로 데이트를 수정하지 않거나 다른 방법으로 사용할 수정 된 값으로 설정Leafdatum다음 단계에서.

새 하위 노드를 추가 해야하는 경우resulttypetoSPGADDNODE. 세트Nodelabel새 노드에 사용될 레이블에Noden노드 어레이에 노드를 삽입 할 인덱스 (0에서)로. 노드가 추가 된 후선택함수는 수정 된 내부 튜플로 다시 호출됩니다. 그 전화는를 초래해야합니다.SPGMATCHNODE결과.

새 값이 튜플 접두사와 일치하지 않는 경우resulttypetoSPGSPLITTUPLE. 이 동작은 기존의 모든 노드를 새로운 하위 레벨 내부 튜플로 이동시키고 기존 내부 튜플을 새로운 하단 내부 튜플을 가리키는 단일 다운 링크를 갖는 튜플로 대체합니다.prefixhasprefix새 튜플에 접두사가 있어야하는지 여부를 나타내려면prefixprefixDatum접두사 값으로. 이 새로운 접두사 값은 색인화 할 새 값을 수락하기 위해 원본보다 충분히 덜 제한적이어야합니다.prefixnnodes새 튜플에 필요한 노드 수로PrefixNodelabels라벨을 보유한 Palloc'd 어레이에 또는 노드 라벨이 필요하지 않은 경우 NULL로. 새로운 상부 튜플의 총 크기는 교체하는 튜플의 총 크기에 지나지 않아야합니다.Childnoden새로운 하위 레벨 내부 튜플로 다운 링크하는 노드의 인덱스 (0에서)로. 세트PostFixHaspRefix새로운 하위 레벨 내부 튜플에 접두사가 있어야하는지 여부를 나타내려면postfixprefixdatum접두사 값으로. 이 두 접두사와 다운 링크 노드의 레이블 (있는 경우)의 조합은 원래의 접두사와 동일한 의미를 가져야합니다. 원래의 접두사와 동일한 의미가 있어야합니다. 왜냐하면 새 하위 수준 튜플로 이동하는 노드 레이블을 변경하거나 하위 인덱스 항목을 변경할 수있는 기회가 없기 때문입니다.선택함수는 교체 내부 튜플로 다시 호출됩니다. 그 전화는 반환 할 수 있습니다SPGADDNODE결과, 적절한 노드가 생성되지 않은 경우SPGSPLITTUPLE행동. 결국선택반환해야합니다SPGMATCHNODE삽입이 다음 단계로 내려 가도록합니다.

잎 튜플 세트에 새로운 내부 튜플을 만드는 방법을 결정합니다.

theSQL함수 선언은 다음과 같아야합니다.

함수 만들기 my_picksplit (내부, 내부) 반환 void ...

첫 번째 인수는 A에 대한 포인터입니다SPGPICKSPLITINc 함수에 대한 입력 데이터를 포함하는 구조. 두 번째 인수는 A에 대한 포인터입니다.SPGPICKSPLITOUTC 구조물, 함수가 결과 데이터로 채워야합니다.

typedef struct spgpicksplitin

ntuples제공된 잎 튜플의 수입니다.DatumsSPGCONFIGOUT.LeafType타입.레벨모든 잎 튜플이 공유하는 현재 레벨이며, 이는 새로운 내부 튜플의 수준이 될 것입니다.

SEThasprefix새 내부 튜플에 접두사가 있어야하는지 여부를 나타내려면PrefixDatum접두사 값으로. 세트nnodes새 내부 튜플이 포함 할 노드 수를 나타내고 설정Nodelabels라벨 값 배열 또는 노드 레이블이 필요하지 않은 경우 NULL로. 세트Maptuplestonodes각 리프 튜플을 할당 해야하는 노드의 인덱스 (0에서)를 제공하는 배열로. 세트Leaftupledatums새로운 잎 튜플에 저장 될 값의 배열로 (입력과 동일합니다Datums운영자 클래스가 한 레벨에서 다음 레벨에서 다음 레벨로 데이 텀을 수정하지 않는 경우).picksplit함수는 palloc'ing the에 책임이 있습니다.Nodelabels, MaptuplestonodesandLeaftupledatums배열.

둘 이상의 잎 튜플이 제공되면picksplit함수는 둘 이상의 노드로 분류됩니다. 그렇지 않으면 잎 튜플을 여러 페이지에 걸쳐 분할 할 수 없습니다. 이는이 작업의 궁극적 인 목적입니다.picksplit함수는 모든 리프 튜플을 동일한 노드에 배치하게됩니다. 코어 SP-Gist 코드는 해당 결정을 무시하고 잎 튜플이 무작위로 동일한 여러 표지 된 노드에 지정되는 내부 튜플을 생성합니다. 그러한 튜플은 표시되어 있습니다Allthesame이것이 일어났다는 것을 의미합니다. 그만큼선택andInner_consistent기능은 그러한 내부 튜플에 적합한주의를 기울여야합니다. 보다섹션 64.3.4.3자세한 내용은

picksplit만으로만 단일 리프 튜플에 적용 할 수 있습니다.config함수 세트LongValuesoktrue로, PAT보다 큰 입력 값이 제공되었습니다. 이 경우 작업의 점은 접두사를 벗기고 새롭고 짧은 잎 기준 값을 생성하는 것입니다.섹션 64.3.4.1자세한 내용은

트리 검색 중에 따라야 할 노드 세트 (분기)를 반환합니다.

theSQL함수 선언은 다음과 같아야합니다.

함수 생성 my_inner_consistent (내부, 내부) 반환 void ...

첫 번째 인수는 A에 대한 포인터입니다SpginnerConsistentinc 함수에 대한 입력 데이터를 포함하는 구조. 두 번째 인수는 A에 대한 포인터입니다.SpginnerConsistentOutC 구조물, 함수가 결과 데이터로 채워야합니다.

typedef struct spginnerconsistentin

배열Scankeys, 길이nkeys, 롤 토토 검색 조건을 설명합니다. 이러한 조건은 결합되며 - 모든 것을 만족시키는 롤 토토 항목 만 흥미 롭습니다.nkeys= 0은 모든 롤 토토 항목이 쿼리를 만족 시킨다는 것을 의미합니다.) 일반적으로 일관된 함수는에만 관심이 있습니다.sk_strategyandsk_argument각 배열 항목의 필드는 각각 색인 가능한 연산자와 비교 값을 제공합니다. 특히 확인할 필요가 없습니다sk_flagsSP-Gist 핵심 코드가 그러한 조건을 필터링하기 때문에 비교 값이 null인지 확인하려면. 배열Orderbys, 길이Norderbys, 주문 연산자 (있는 경우)를 같은 방식으로 설명합니다.재구성 value부모 튜플에 대해 재구성 된 값입니다. 그것은(Datum) 0루트 레벨에서 또는Inner_consistent함수는 부모 수준에서 값을 제공하지 않았습니다.TraversalValue이전 호출에서 전달 된 트래버스 데이터에 대한 포인터입니다.Inner_consistent부모 색인 튜플에서 또는 루트 레벨의 널.TraversalMemoryContext출력 트래버스 값을 저장하는 메모리 컨텍스트 (아래 참조).레벨는 루트 레벨의 경우 0에서 시작하는 현재 튜플 레벨입니다.returnDataistrue이 쿼리에 재구성 된 데이터가 필요한 경우; 이것은만큼 그렇게 될 것입니다config기능 주장CanreturnData. Allthesame전류 내부 튜플이 표시되면 참입니다“All-the-Same”; 이 경우 모든 노드는 동일한 레이블 (있는 경우)을 가지므로 쿼리와 일치하거나 전혀 일치합니다 (참조섹션 64.3.4.3). hasprefix전류 내부 튜플에 접두사가 포함되어 있으면 참입니다. 그렇다면,PrefixDatum값입니다.nnodes내부 튜플에 포함 된 자식 노드의 수는Nodelabels노드에 레이블이없는 경우 레이블 값의 배열이거나 NULL입니다.

nnodes검색에서 방문 해야하는 자식 노드 수로 설정해야합니다.Nodenumbers인덱스 배열로 설정해야합니다. 운영자 클래스가 레벨을 추적하는 경우levelAdds방문 할 각 노드로 내려갈 때 필요한 레벨 증분 배열로. (종종 이러한 증분은 모든 노드에서 동일하지만 반드시 그렇지는 않기 때문에 배열이 사용됩니다.) 값 재구성이 필요한 경우재구성방문 할 각 어린이 노드에 대해 재구성 된 값의 배열; 그렇지 않으면 떠나재구성null로. 재구성 된 값은 유형으로 가정됩니다SPGCONFIGOUT.LeafType. (그러나 핵심 시스템은 그것들을 복사 할 가능성을 제외하고는 그들과 아무것도하지 않을 것이기 때문에, 그들이 동일하게하기에 충분합니다.Typlenandtypbyval속성 asLeafType.) 순서 검색이 수행되면 SET거리에 따른 거리 값의 배열로Orderbys배열 (먼 거리가 가장 낮은 노드가 먼저 처리됩니다). 그렇지 않으면 Null을 남겨 두십시오.“트래버스 값”) 트리 검색의 낮은 레벨에서 세트TraversalValues적절한 트래버스 값의 배열로, 각 어린이 노드에 대해 하나는 방문 할; 그렇지 않으면 떠나TraversalValuesnull로.Inner_consistent함수는 palloc'ing the에 책임이 있습니다.Nodenumbers, levelAdds, 거리, 재구성및TraversalValues현재 메모리 컨텍스트의 배열. 그러나, 출력 트래버스 값은TraversalValues배열을 할당해야합니다TraversalMemoryContext. 각 트래버스 값은 단일 palloc'd 청크 여야합니다.

리프 튜플이 쿼리를 만족시키는 경우 true를 반환합니다.

theSQL함수 선언은 다음과 같아야합니다.

함수 생성 my_leaf_consistent (내부, 내부) 반환 bool ...

첫 번째 인수는 A에 대한 포인터입니다spleafconsistentinc 함수에 대한 입력 데이터를 포함하는 구조. 두 번째 인수는 A에 대한 포인터입니다.spleafconsistentoutC 구조물, 함수가 결과 데이터로 채워야합니다.

typedef struct spleafconsistentin

배열Scankeys, 길이nkeys, 롤 토토 검색 조건을 설명합니다. 이러한 조건은 결합되며 - 모두를 만족시키는 롤 토토 항목 만 쿼리를 만족시킵니다.nkeys= 0은 모든 롤 토토 항목이 쿼리를 만족 시킨다는 것을 의미합니다.) 일반적으로 일관된 함수는에만 관심이 있습니다.sk_strategyandsk_argument각 배열 항목의 필드는 각각 색인 가능한 연산자와 비교 값을 제공합니다. 특히 확인할 필요가 없습니다sk_flagsSP-Gist 핵심 코드가 그러한 조건을 필터링하기 때문에 비교 값이 null인지 확인하려면. 배열Orderbys, 길이Norderbys, 주문 연산자를 같은 방식으로 설명합니다.재구성 value부모 튜플에 대해 재구성 된 값입니다. 그것은(Datum) 0루트 레벨에서 또는Inner_consistent함수는 부모 수준에서 값을 제공하지 않았습니다.TraversalValue이전 호출에서 전달 된 트래버스 데이터에 대한 포인터입니다.Inner_consistent부모 색인 튜플에서 또는 루트 레벨의 널.레벨는 루트 레벨의 경우 0에서 시작하는 현재 잎 튜플 레벨입니다.returnDataistrue이 쿼리에 재구성 된 데이터가 필요한 경우; 이것은만큼 그렇게 될 것입니다config기능 주장CanreturnData. Leafdatum의 핵심 값입니다.SPGCONFIGOUT.LeafType현재 잎 튜플에 저장되었습니다.

함수가 반환해야합니다true리프 튜플이 쿼리와 일치하는 경우false그렇지 않은 경우. 에서truecase, ifreturnDataistruetheLeafValue(유형 값으로 설정해야합니다.SPGCONFIGIN.atttype) 원래이 잎 튜플에 대한 색인으로 제공되었습니다. 또한,다시 확인로 설정 될 수 있습니다true일치가 불확실하고 연산자가 실제 힙 튜플에 다시 적용되어 일치를 확인해야합니다. 주문한 검색이 수행되면 SET거리에 따른 거리 값의 배열로Orderbys배열. 그렇지 않으면 Null을 남겨 두십시오.RecheckDistancestrue. 이 경우, executor는 튜플을 힙에서 가져온 후 정확한 거리를 계산하고 필요한 경우 튜플을 재정렬합니다..

데이터 항목을 롤 토토의 리프 튜플에서 물리적 저장에 적합한 형식으로 변환합니다. 유형의 값을 받아들입니다SPGCONFIGIN.atttype유형 값을 반환SPGCONFIGOUT.LeafType. 출력 값에는 외부의 토스트 포인터가 포함되어서는 안됩니다.

참고 :compress메소드는 저장할 값에만 적용됩니다. 일관된 방법은 쿼리를받습니다Scankeys변환없이 변경되지 않았습니다compress.

운영자 클래스 동작을 제어하는 ​​사용자가 가시 가능한 매개 변수 세트를 정의합니다.

theSQL함수 선언은 다음과 같아야합니다.

함수 생성 또는 교체 my_options (내부)void를 반환합니다

함수가 A로 포인터가 전달됩니다local_reloptsSTRUCT는 일련의 운영자 클래스 특정 옵션으로 채워야합니다. 옵션은를 사용하여 다른 지원 기능에서 액세스 할 수 있습니다.pg_has_opclass_options ()andpg_get_opclass_options ()매크로

키를 표현한 이후SP-Gist융통성이 있으며 사용자 지정 매개 변수에 따라 다를 수 있습니다.