55.2. 스포츠 토토 베트맨 액세스 방법 기능

색인 액세스 방법이 제공해야 하는 색인 구성 및 유지 관리 기능은 다음과 같습니다.

IndexBuildResult *
ambuild(관계 힙Relation,
         관계 지수관계,
         IndexInfo *indexInfo);

새 색인을 구축하세요. 스포츠 토토 베트맨 관계가 물리적으로 생성되었지만 비어 있습니다. 액세스 방법에 필요한 고정 데이터와 테이블에 이미 존재하는 모든 튜플에 대한 항목으로 채워져야 합니다. 일반적으로ambuild함수가 호출됩니다IndexBuildHeapScan()테이블에서 기존 튜플을 검색하고 스포츠 토토 베트맨에 삽입해야 하는 키를 계산합니다. 함수는 새 스포츠 토토 베트맨에 대한 통계를 포함하는 palloc'd 구조체를 반환해야 합니다.

공허
ambuildempty(관계 indexRelation);

빈 색인을 구축하고 초기화 포크에 씁니다(INIT_FORKNUM) 해당 관계의 이 메서드는 기록되지 않은 테이블에 대해서만 호출됩니다. 초기화 포크에 기록된 빈 스포츠 토토 베트맨는 서버를 다시 시작할 때마다 기본 관계 포크 위에 복사됩니다.

부울
aminsert(관계 스포츠 토토 베트맨Relation,
          데이텀 *값,
          부울 *isnull,
          ItemPointer heap_tid,
          관계 힙관계,
          IndexUniqueCheck checkUnique);

기존 색인에 새 튜플을 삽입하십시오.값그리고isnull배열은 색인화할 키 값을 제공하며heap_tid은 인덱싱할 TID입니다. 액세스 방법이 고유 인덱스를 지원하는 경우(해당pg_am.amcanunique플래그가 참임) 그런 다음checkUnique수행할 고유성 검사 유형을 나타냅니다. 이는 고유 제한조건이 연기 가능한지 여부에 따라 달라집니다. 참조PostgreSQL : 문서 : 9.4 : 색인 토토 결과 확인11998_12056힙관계고유성 검사를 수행할 때 매개변수(이후 튜플 활성 여부를 확인하려면 힙을 조사해야 합니다).

함수의 부울 결과 값은 다음 경우에만 중요합니다.checkUniqueisUNIQUE_CHECK_PARTIAL. 이 경우 TRUE 결과는 새 항목이 고유한 것으로 알려졌음을 의미하고, FALSE는 해당 항목이 고유하지 않을 수 있음을 의미합니다(그리고 지연된 고유성 확인을 예약해야 함). 다른 경우에는 일정한 FALSE 결과가 권장됩니다.

일부 색인은 모든 튜플의 색인을 생성하지 않을 수 있습니다. 튜플을 색인화하지 않는 경우,아민서트아무것도 하지 않고 그냥 돌아가야 합니다.

IndexBulkDeleteResult *
ambulkdelete(IndexVacuumInfo *정보,
              IndexBulkDeleteResult *통계,
              IndexBulkDeleteCallback 콜백,
              무효 *callback_state);

색인에서 튜플을 삭제합니다. 이것은"대량 삭제"전체 색인을 스캔하고 각 항목을 삭제해야 하는지 확인하여 구현하려는 작업입니다. 전달된콜백함수는 스타일에서 호출되어야 합니다.콜백(TID, callback_state)는 bool을 반환합니다.- 참조된 TID로 식별되는 특정 인덱스 항목을 삭제할지 여부를 결정합니다. 삭제 작업의 효과에 대한 통계를 포함하는 NULL 또는 palloc'd 구조체를 반환해야 합니다. 정보를 전달할 필요가 없으면 NULL을 반환해도 괜찮습니다.amvacuumcleanup.

제한적이기 때문에maintenance_work_mem, ambulkdelete많은 튜플을 삭제하려면 두 번 이상 호출해야 할 수도 있습니다.통계인수는 이 인덱스에 대한 이전 호출의 결과입니다(a 내의 첫 번째 호출에서는 NULL입니다.진공작동). 이를 통해 AM은 전체 작업에 걸쳐 통계를 축적할 수 있습니다. 일반적으로ambulkdelete전달된 경우 동일한 구조체를 수정하고 반환합니다통계널이 아닙니다.

IndexBulkDeleteResult *
amvacuumcleanup(IndexVacuumInfo *정보,
                 IndexBulkDeleteResult *통계);

다음 이후 정리진공연산(0개 이상ambulkdelete호출). 인덱스 통계를 반환하는 것 외에는 아무 작업도 수행할 필요가 없지만 빈 인덱스 페이지 회수와 같은 대량 정리를 수행할 수 있습니다.통계무엇이든 마지막이군요ambulkdelete호출이 반환되었습니다. 또는 다음의 경우 NULL입니다.ambulkdelete삭제할 튜플이 없기 때문에 호출되지 않았습니다. 결과가 NULL이 아닌 경우 palloc 구조체여야 합니다. 포함된 통계는 업데이트하는 데 사용됩니다.pg_class, 다음 사람이 보고합니다.진공if상세주어집니다. 동안 스포츠 토토 베트맨가 전혀 변경되지 않은 경우 NULL을 반환해도 괜찮습니다.진공작업이지만 그렇지 않으면 올바른 통계가 반환되어야 합니다.

현재PostgreSQL 8.4, amvacuumcleanup또한 완료 시 호출됩니다분석작업. 이 경우통계은 항상 NULL이며 모든 반환 값은 무시됩니다. 이 경우는 다음을 확인하여 구별할 수 있습니다.info-analyze_only. 액세스 방법은 이러한 호출에서 삽입 후 정리 외에는 아무것도 수행하지 않고 autovacuum 작업자 프로세스에서만 수행하는 것이 좋습니다.

부울
amcanreturn(관계 indexRelation);

색인이 지원할 수 있는지 확인색인 전용 스캔색인 항목에 대한 색인화된 열 값을 형식으로 반환하여IndexTuple. 그렇다면 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다. 인덱스 AM이 인덱스 전용 스캔을 결코 지원할 수 없는 경우(예: 원본 데이터가 아닌 해시 값만 저장하는 해시) 해당amcanreturn필드를 0으로 설정pg_am.

공허
amcostestimate(PlannerInfo *루트,
                IndexPath *경로,
                이중 루프_카운트,
                비용 *indexStartupCost,
                비용 *indexTotalCost,
                선택성 *indexSelectivity,
                double *indexCorrelation);

인덱스 스캔 비용을 추정합니다. 이 기능은 다음에서 자세히 설명됩니다.PostgreSQL : 문서 : 9.4 : 색인 토토 베이 추정 기능, 아래.

바이테아 *
amoptions(ArrayType *reloptions,
           부울 검증);

인덱스에 대한 reloptions 배열을 구문 분석하고 검증합니다. 이는 null이 아닌 reloptions 배열이 인덱스에 존재할 때만 호출됩니다.reloptions은텍스트다음 형식의 항목을 포함하는 배열이름=값. 함수는 다음을 구성해야 합니다.바이테아값, 다음으로 복사될 값rd_options색인의 recache 항목 필드입니다. 의 데이터 내용바이테아값은 정의할 액세스 방법에 대해 열려 있습니다. 대부분의 표준 액세스 방법은 struct를 사용합니다.StdRdOptions. 언제확인이 true입니다. 옵션 중 하나라도 인식되지 않거나 유효하지 않은 값이 있는 경우 함수는 적절한 오류 메시지를 보고해야 합니다. 언제확인이 false이면 유효하지 않은 항목은 자동으로 무시되어야 합니다. (확인이미 저장된 옵션을 로드하는 경우 false입니다.pg_catalog; 유효하지 않은 항목은 액세스 방법이 옵션에 대한 규칙을 변경한 경우에만 찾을 수 있으며, 이 경우 사용되지 않는 항목을 무시하는 것이 적절합니다.) 기본 동작을 원할 경우 NULL을 반환해도 괜찮습니다.

물론 색인의 목적은 색인 생성 가능 항목과 일치하는 튜플에 대한 검색을 지원하는 것입니다.어디조건, 흔히 a라고 함한정자또는스캔 키. 인덱스 스캐닝의 의미는 다음에서 더 자세히 설명됩니다.PostgreSQL : 문서 : 9.4 : 인덱스 토토 커뮤니티, 아래. 인덱스 액세스 방법은 다음을 지원할 수 있습니다."일반"색인 스캔,"비트맵"색인 스캔 또는 둘 다. 인덱스 액세스 방법이 제공해야 하거나 제공할 수 있는 스캔 관련 기능은 다음과 같습니다.

IndexScanDesc
ambeginscan(관계 스포츠 토토 베트맨Relation,
             int nkeys,
             int norderbys);

스포츠 토토 베트맨 스캔을 준비하십시오.n키그리고노르더비매개변수는 스캔에 사용될 한정어 및 순서 연산자의 수를 나타냅니다. 이는 공간 할당 목적으로 유용할 수 있습니다. 스캔 키의 실제 값은 아직 제공되지 않습니다. 결과는 palloc'd 구조체여야 합니다. 구현상의 이유로 인덱스 액세스 방법반드시호출하여 이 구조체를 생성RelationGetIndexScan(). 대부분의 경우ambeginscan호출을 하고 아마도 잠금을 획득하는 것 외에는 거의 수행하지 않습니다. 인덱스 스캔 시작의 흥미로운 부분은 다음과 같습니다.amrescan.

공허
amrescan(IndexScanDesc 스캔,
          스캔키 키,
          int nkeys,
          ScanKey 주문,
          int norderbys);

가능한 경우 새 스캔 키를 사용하여 인덱스 스캔을 시작하거나 다시 시작합니다. (이전에 전달된 키를 사용하여 다시 시작하려면 NULL이 전달됩니다.키및/또는orderbys.) 키 수 또는 정렬 기준 연산자가 전달된 것보다 큰 것은 허용되지 않습니다.ambeginscan. 실제로는 중첩 루프 조인에 의해 새로운 외부 튜플이 선택되어 새로운 키 비교 값이 필요할 때 다시 시작 기능이 사용되지만 스캔 키 구조는 동일하게 유지됩니다.

부울
amgettuple(IndexScanDesc 스캔,
            스캔 방향 방향);

주어진 스캔에서 주어진 방향(인덱스의 앞이나 뒤)으로 이동하면서 다음 튜플을 가져옵니다. 튜플을 얻었으면 TRUE를 반환하고, 일치하는 튜플이 남아 있지 않으면 FALSE를 반환합니다. TRUE의 경우 튜플 TID는스캔구조. 참고하세요"성공"은 인덱스에 검색 키와 일치하는 항목이 포함되어 있다는 의미일 뿐, 튜플이 반드시 힙에 여전히 존재하거나 호출자의 스냅샷 테스트를 통과한다는 의미는 아닙니다. 성공하면,amgettuple또한 설정해야 함스캔-xs_recheck참 또는 거짓으로. FALSE는 인덱스 항목이 스캔 키와 일치하는 것이 확실하다는 것을 의미합니다. TRUE는 이것이 확실하지 않다는 것을 의미하며 스캔 키로 표시되는 조건을 가져온 후 힙 튜플에 대해 다시 확인해야 합니다. 이 조항은 다음을 지원합니다."손실"색인 연산자. 재검사는 스캔 조건까지만 확장됩니다. 부분 인덱스 조건자(있는 경우)는 절대로 다시 확인되지 않습니다.amgettuple발신자.

인덱스가 인덱스 전용 스캔을 지원하는 경우(예:amcanreturnTRUE를 반환함), 성공하면 AM도 확인해야 합니다스캔-xs_want_itup, 그리고 그것이 사실이라면 인덱스 항목에 대한 원래 인덱스 데이터를 다음 형식으로 반환해야 합니다.IndexTuple포인터가 다음에 저장됨스캔-xs_itup, 튜플 설명자 포함스캔-xs_itupdesc. (포인터가 참조하는 데이터 관리는 액세스 방법의 책임입니다. 데이터는 적어도 다음까지 양호한 상태로 유지되어야 합니다.amgettuple, amrescan또는수정스캔스캔을 요청하세요.)

그amgettuple액세스 방법이 지원하는 경우에만 함수를 제공해야 합니다."일반"색인 스캔. 그렇지 않은 경우에는amgettuple필드의 필드pg_am행은 0으로 설정되어야 합니다.

int64
amgetbitmap(IndexScanDesc 스캔,
             TIDB비트맵 *tbm);

주어진 스캔에서 모든 튜플을 가져와서 호출자 제공에 추가TIDB비트맵(즉, 또는 이미 비트맵에 있는 세트에 대한 튜플 ID 세트). 가져온 튜플의 수가 반환됩니다(예를 들어 일부 AM은 중복을 감지하지 못하는 대략적인 수일 수 있습니다). 비트맵에 튜플 ID를 삽입하는 동안amgetbitmap은 특정 튜플 ID에 대해 검색 조건을 다시 확인해야 함을 나타낼 수 있습니다. 이는 다음과 유사합니다.xs_recheck출력 매개변수amgettuple. 참고: 현재 구현에서 이 기능에 대한 지원은 비트맵 자체의 손실 저장에 대한 지원과 통합되어 있으므로 호출자는 다시 확인 가능한 튜플에 대한 스캔 조건과 부분 인덱스 조건자(있는 경우)를 모두 다시 확인합니다. 그러나 그것이 항상 사실이 아닐 수도 있습니다.amgetbitmap그리고amgettuple동일한 인덱스 스캔에서는 사용할 수 없습니다. 사용할 때 다른 제한 사항도 있습니다.amgetbitmap, 설명된 대로PostgreSQL : 문서 : 9.4 : 인덱스 토토 커뮤니티.

그amgetbitmap액세스 방법이 지원하는 경우에만 기능을 제공해야 합니다."비트맵"색인 스캔. 그렇지 않은 경우에는amgetbitmap필드의 필드pg_am행은 0으로 설정되어야 합니다.

공허
amendscan(IndexScanDesc 스캔);

스캔을 종료하고 자원을 해제합니다.스캔구조체 자체는 해제되어서는 안 되지만, 액세스 방법에 의해 내부적으로 취해진 모든 잠금 또는 핀은 해제되어야 하며, 다음에 의해 할당된 다른 메모리도 해제되어야 합니다.ambeginscan및 기타 스캔 관련 기능.

공허
ammarkpos(IndexScanDesc 스캔);

현재 스캔 위치를 표시합니다. 액세스 방법은 스캔당 하나의 기억된 스캔 위치만 지원하면 됩니다.

공허
amrestrpos(IndexScanDesc 스캔);

가장 최근에 표시된 위치로 스캔을 복원합니다.

관례적으로,pg_proc스포츠 토토 베트맨 액세스 방법 함수에 대한 항목은 올바른 인수 수를 표시해야 하지만 모두 유형으로 선언해야 합니다.내부(대부분의 인수에는 SQL에 알려지지 않은 유형이 있고 어쨌든 사용자가 함수를 직접 호출하는 것을 원하지 않기 때문입니다). 반환 유형은 다음과 같이 선언됩니다.무효, 내부또는부울적절하게. 유일한 예외는선택 사항, 복용으로 올바르게 선언되어야 합니다.텍스트[]그리고부울그리고 돌아오는 중바이테아. 이 조항을 통해 클라이언트 코드를 실행할 수 있습니다.선택사항옵션 설정의 유효성을 테스트합니다.