52.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표시 수행할 고유성 검사 유형입니다. 이는 다음에 따라 다릅니다. 고유 제약조건이 연기 가능한지 여부 참조섹션 52.512160_12220힙관계12258_12384

함수의 부울 결과 값은 다음 경우에만 중요합니다.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수정하고 반환합니다 전달된 경우 동일한 구조체통계이다 null이 아닙니다.

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

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

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

공허
amcostestimate(PlannerInfo *루트,
                IndexOptInfo *색인,
                *indexQuals 나열,
                *indexOrderBys 목록,
                RelOptInfo *outer_rel,
                비용 *indexStartupCost,
                비용 *indexTotalCost,
                선택성 *indexSelectivity,
                double *indexCorrelation);

토토 스캔 비용을 추정합니다. 이 기능은 에 자세히 설명되어 있습니다.PostgreSQL : 문서 : 9.1 : 색인 메이저 토토 사이트 추정 기능, 아래.

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

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

물론 색인의 목적은 다음에 대한 검색을 지원하는 것입니다. 인덱싱 가능 항목과 일치하는 튜플어디조건, 흔히 a라고 함한정자또는스캔 키. 토토의 의미 스캔에 대한 자세한 내용은섹션 52.3, 아래. 인덱스 액세스 메소드가 지원할 수 있음"일반"색인 스캔,"비트맵"색인 스캔 또는 둘 다. 인덱스 액세스 방법이 반드시 수행해야 하는 스캔 관련 기능 또는 다음을 제공할 수 있습니다:

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_recheckTRUE 또는 거짓. FALSE는 인덱스 항목이 일치하는 것이 확실하다는 것을 의미합니다. 스캔 키. TRUE는 확실하지 않음을 의미하며 조건은 다음과 같습니다. 스캔 키로 표시되는 항목은 힙에 대해 다시 확인되어야 합니다. 그것을 가져온 후 튜플. 이 조항은 다음을 지원합니다."손실"색인 연산자. 다시 확인하면 스캔 조건으로만 확장합니다. 부분 인덱스 술어(인 경우 any)는 결코 다시 확인되지 않습니다.amgettuple발신자.

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

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

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

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

공허
amendscan(IndexScanDesc 스캔);

스캔을 종료하고 자원을 해제합니다.스캔구조체 자체는 해제되어서는 안 됩니다. 접근 방법에 의해 내부적으로 확보된 자물쇠나 핀은 반드시 석방되었습니다.

공허
ammarkpos(IndexScanDesc 스캔);

현재 스캔 위치를 표시합니다. 액세스 방법은 다음과 같습니다. 스캔당 하나의 기억된 스캔 위치를 지원합니다.

공허
amrestrpos(IndexScanDesc 스캔);

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

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