사설 토토

설명

사설 토토지정된 것을 실행합니다 에 대한 SQL 명령count행. 만약에read_onlyistrue, 명령은 읽기 전용이어야하며 실행해야합니다 오버 헤드가 다소 줄어 듭니다.

이 함수는 연결된 절차에서만 호출 할 수 있습니다.

ifcount는 0입니다 적용되는 모든 행에 대해 실행됩니다. 만약에count| 0보다 크면count행이 검색됩니다. 실행 a와 마찬가지로 카운트에 도달하면 중지됩니다.Limit쿼리에 대한 조항. 예를 들어,

사설 토토 ( "선택 * From Foo", True, 5);

테이블에서 최대 5 행을 검색합니다. 그런 것입니다 한계는 명령이 실제로 행을 반환 할 때만 유효합니다. 을 위한 예,

사설 토토 ( "foo에 삽입 *에서 선택 *에서 삽입", false, 5);

모든 행을 삽입합니다bar, 무시 그만큼count매개 변수. 그러나

사설 토토 ( "foo에 삽입 * 삽입 *에서 bar returning *", false, 5);

실행이 중지되므로 최대 5 행이 삽입됩니다. 다섯 번째 이후반환결과 행입니다 검색.

하나의 문자열로 여러 명령을 전달할 수 있습니다;사설 토토명령의 결과를 반환합니다 마지막으로 실행되었습니다. 그만큼count제한이 적용됩니다 각 명령에 별도로 (마지막 결과 만 실제로 반환됩니다). 한계는 숨겨진 곳에 적용되지 않습니다 규칙에 의해 생성 된 명령.

언제read_onlyisfalse, 사설 토토명령 카운터를 증가시키고 새로 계산합니다스냅 샷에서 각 명령을 실행하기 전에 끈. 전류가 있으면 실제로 스냅 샷이 변경되지 않습니다 트랜잭션 격리 수준은SERIALIZALE또는반복 가능 읽다하지만Committed모드 스냅 샷 업데이트는 각 명령이 새로의 결과를 볼 수 있도록합니다. 다른 세션에서 저지른 거래. 이것은 필수적입니다 명령이 수정 될 때 일관된 동작 데이터 베이스.

언제read_onlyistrue, 사설 토토스냅 샷 또는 명령 카운터를 업데이트하지 않으면 평원 만 허용select명령 명령 문자열에 나타납니다. 명령은 주변 쿼리를 위해 이전에 설정된 스냅 샷. 이것 실행 모드는 명령 당 오버 헤드 제거. 또한 진정으로 허용안정적인빌드 할 기능 : 이후 연속적인 실행은 모두 동일한 스냅 샷을 사용할 것입니다. 결과에는 변화가 없습니다.

일반적으로 읽기 전용 및 읽기 쓰기 명령을 혼합하는 것은 현명하지 않습니다. SPI를 사용한 단일 함수 내에서; 그것은 매우 생성 될 수 있습니다 읽기 전용 쿼리는 읽기 쓰기 쿼리로 수행 된 데이터베이스 업데이트 결과.

(마지막) 명령이 있었던 실제 행 수 실행 된 Global Variable에서 실행 된SPI_PROCESSED. 함수의 반환 값 인 경우 이다spi_ok_select, spi_ok_insert_returning, spi_ok_delete_returning또는spi_ok_update_returning, 그런 다음 글로벌을 사용할 수 있습니다 바늘spitupletable *spi_tuptableTO 결과 행에 액세스하십시오. 일부 유틸리티 명령 (예 :설명) 또한 행 세트를 반환하고spi_tuptable이 경우 결과를 포함합니다 도. 일부 유틸리티 명령 (COPY, 테이블 작성) 행 세트를 반환하지 마십시오. 그래서SPI_TUPTable는 null이지만 여전히 처리 된 행 수를 반환SPI_PROCESSED.

구조spitupletableis 이렇게 정의 됨 :

typedef struct

    MemoryContext tuptabcxt;    / * 결과 테이블의 메모리 컨텍스트 */
    UINT32 할당;        / * 할당 된 vals 수 */
    UINT32 무료;           / * 무료 VAL의 수 */
    tupledesc tupdesc;        / * 행 설명자 */
    heppuple *vals;           / * 행 */
 spitupletable;

vals는 다양한 포인터입니다 줄. (유효한 항목의 수는에 의해 제공됩니다.SPI_PROCESSED.)TupdescSPI 기능으로 전달할 수있는 행 디스크립터입니다. 줄로.tuptabcxt, 할당및무료SPI 발신자가 사용하기위한 내부 필드입니다.

SPI_FINISH모든 것을 해방spitupletable전류 중에 할당되었습니다 절차. 특정 결과 테이블을 일찍 자유롭게 해제 할 수 있습니다. 전화를 통해 끝났습니다SPI_FREETUPTABLE.

인수

반환 값

명령의 실행이 성공적이면 다음 (음이 아닌) 값이 반환됩니다.

오류에서 다음 음수 값 중 하나가 반환됩니다.

노트

모든 SPI Query-Execution Functions Set 두 가지SPI_PROCESSEDandspi_tuptable(내용이 아닌 포인터 만 구조). 이 두 가지 글로벌 변수를 로컬에 저장하십시오 절차 변수 결과 테이블에 액세스 해야하는 경우사설 토토또는 다른 이후 통화에 걸친 쿼리-실행 함수.