TSM 핸들러 함수는 palloc'd를 반환합니다.Tsm루틴구조체에는 아래 설명된 지원 함수에 대한 포인터가 포함되어 있습니다. 대부분의 함수는 필수이지만 일부는 선택 사항이며 해당 포인터는 NULL일 수 있습니다.

공허
SampleScanGetSampleSize(PlannerInfo *루트,
                         RelOptInfo *baserel,
                         *parameexprs 나열,
                         BlockNumber *페이지,
                         이중 *튜플);

이 기능은 계획 중에 호출됩니다. 샘플 스캔 중에 읽을 관계 페이지 수와 스캔에서 선택될 튜플 수를 추정해야 합니다. (예를 들어, 이는 샘플링 비율을 추정한 다음 다음을 곱하여 결정될 수 있습니다.바셀-페이지그리고바세렐-튜플숫자에 따라 결과를 정수 값으로 반올림해야 합니다.) Theparameexprs목록에는 매개변수인 표현식이 포함되어 있습니다.테이블 샘플절. 사용하는 것이 좋습니다추정_표현_값()추정 목적으로 해당 값이 필요한 경우 이러한 표현식을 상수로 줄이려고 합니다. 그러나 함수는 크기 추정치를 줄일 수 없는 경우에도 제공해야 하며 값이 유효하지 않은 것처럼 보이더라도 실패해서는 안 됩니다(런타임 값이 어떻게 될지에 대한 추정치일 뿐이라는 점을 기억하세요).페이지그리고튜플매개변수는 출력입니다.

공허
InitSampleScan(SampleScanState *노드,
                int 플래그);

SampleScan 계획 노드 실행을 위해 초기화합니다. 이는 실행기 시작 중에 호출됩니다. 처리가 시작되기 전에 필요한 초기화를 수행해야 합니다.SampleScanState노드가 이미 생성되었지만tsm_state필드가 NULL입니다.InitSampleScan함수는 스포츠 토토 방법에 필요한 내부 상태 데이터가 무엇이든 palloc할 수 있으며 이에 대한 포인터를 저장할 수 있습니다.노드-tsm_state. 스캔할 테이블에 대한 정보는의 다른 필드를 통해 액세스할 수 있습니다.SampleScanState노드(단,노드-ss.ss_currentScanDesc스캔 설명자가 아직 설정되지 않았습니다.)플래그이 계획 노드에 대한 실행기의 작동 모드를 설명하는 플래그 비트를 포함합니다.

언제(플래그 및 EXEC_FLAG_EXPLAIN_ONLY)이 true이면 스캔이 실제로 수행되지 않으므로 이 함수는 노드 상태를 유효하게 만드는 데 필요한 최소한의 작업만 수행해야 합니다.설명그리고EndSampleScan.

이 함수는 생략될 수 있습니다(포인터를 NULL로 설정). 이 경우BeginSampleScan스포츠 토토 방법에 필요한 모든 초기화를 수행해야 합니다.

공허
BeginSampleScan(SampleScanState *노드,
                 데이텀 *매개변수,
                 정수 nparams,
                 uint32 시드);

샘플링 스캔 실행을 시작합니다. 이는 튜플을 가져오려는 첫 번째 시도 직전에 호출되며, 스캔을 다시 시작해야 하는 경우 다시 호출될 수 있습니다. 스캔할 테이블에 대한 정보는 필드를 통해 액세스할 수 있습니다.SampleScanState노드(단,노드-ss.ss_currentScanDesc스캔 설명자가 아직 설정되지 않았습니다).매개변수배열, 길이nparams, 에 제공된 매개변수 값을 포함합니다.테이블 샘플절. 이는 스포츠 토토 방법에 지정된 수와 유형을 갖습니다.매개변수 유형목록이며 null이 아닌 것으로 확인되었습니다.씨앗스포츠 토토 방법 내에서 생성된 난수에 사용할 시드를 포함합니다. 이는에서 파생된 해시이거나반복 가능하나가 주어진 경우 값 또는 결과무작위()그렇지 않다면.

이 기능은 필드를 조정할 수 있습니다.노드-use_bulkread그리고노드-use_pagemode. 만일노드-use_bulkreadis참(기본적으로) 스캔에서는 사용 후 버퍼 재활용을 장려하는 버퍼 액세스 전략을 사용합니다. 이것을 다음과 같이 설정하는 것이 합리적일 수 있습니다.거짓스캔이 테이블 페이지의 작은 부분만 방문하는 경우. 만일노드-use_pagemodeis참, 기본적으로 스캔은 방문한 각 페이지의 모든 튜플에 대해 단일 패스로 가시성 검사를 수행합니다. 이것을 다음과 같이 설정하는 것이 합리적일 수 있습니다.거짓스캔이 방문한 각 페이지에서 튜플의 작은 부분만 선택하는 경우. 그러면 수행되는 튜플 가시성 검사 수가 줄어들지만 더 많은 잠금이 필요하기 때문에 각 검사 비용이 더 많이 듭니다.

스포츠 토토 방법이 표시된 경우repeatable_across_scans, 원래와 마찬가지로 재검색 중에 동일한 튜플 세트를 선택할 수 있어야 합니다. 이는의 새로운 호출입니다.BeginSampleScan이전과 동일한 튜플을 선택해야 합니다(만약테이블 샘플매개변수 및 시드는 변경되지 않습니다.)

블록 번호
NextSampleBlock(SampleScanState *node, BlockNumber nblocks);

스캔할 다음 페이지의 블록 번호를 반환합니다. 또는잘못된 블록번호스캔할 페이지가 남아 있지 않은 경우.

이 함수는 생략될 수 있습니다(포인터를 NULL로 설정). 이 경우 핵심 코드는 전체 관계의 순차적 스캔을 수행합니다. 이러한 스캔은 동기화된 스캔을 사용할 수 있으므로 샘플링 방법은 각 스캔에서 동일한 순서로 관계 페이지가 방문된다고 가정할 수 없습니다.

오프셋번호
NextSampleTuple(SampleScanState *노드,
                 블록번호 블록번호,
                 오프셋 번호 maxoffset);

지정된 페이지에서 샘플링될 다음 튜플의 오프셋 번호를 반환합니다. 또는InvalidOffsetNumber샘플링할 튜플이 남아 있지 않은 경우.최대 오프셋페이지에서 사용 중인 가장 큰 오프셋 숫자입니다.

공허
EndSampleScan(SampleScanState *노드);

스캔을 종료하고 리소스를 해제합니다. 일반적으로 palloc 메모리를 해제하는 것은 중요하지 않지만 외부에 표시되는 리소스는 모두 정리해야 합니다. 이러한 리소스가 없는 일반적인 경우에는 이 함수를 생략할 수 있습니다(포인터를 NULL로 설정).