젠 토토

설명

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

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

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

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

테이블에서 최대 5 행을 검색합니다. 이러한 제한은 명령이 실제로 행을 반환 할 때만 유효합니다. 예를 들어,

젠 토토 ( "foo에 삽입 *에서 * 삽입 *에서 삽입", false, 5);

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

spi_execute ( "foo에 삽입 * 선택 *에서 bar returning *", false, 5);

5 번째 행이 삽입됩니다.반환결과 행이 검색되었습니다.

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

언제read_onlyisfalse, 젠 토토명령 카운터를 증가시키고 새로 계산합니다스냅 샷문자열에서 각 명령을 실행하기 전에. 현재 트랜잭션 격리 레벨이 인 경우 스냅 샷이 실제로 변경되지 않습니다.SERIALIZABLE또는반복 가능한 읽기하지만Commited 읽기12326_12533

언제read_onlyistrue, 젠 토토스냅 샷 또는 명령 카운터를 업데이트하지 않으며 일반 만 허용select명령 문자열에 표시되는 명령. 명령은 주변 쿼리에 대해 이전에 설정된 스냅 샷을 사용하여 실행됩니다. 이 실행 모드는 명령 당 오버 헤드를 제거하여 읽기/쓰기 모드보다 다소 빠릅니다. 또한 진정으로 허용안정적인제작할 기능 : 연속 실행이 모두 동일한 스냅 샷을 사용하므로 결과에 변화가 없을 것입니다..

SPI를 사용하여 단일 함수 내에서 읽기 전용 및 읽기 쓰기 명령을 혼합하는 것은 일반적으로 현명하지 않습니다. 읽기 전용 쿼리는 읽기 쓰기 쿼리에 의해 수행 된 데이터베이스 업데이트의 결과를 볼 수 없기 때문에 매우 혼란스러운 동작을 초래할 수 있습니다..

(마지막) 명령이 실행 된 실제 행 수는 글로벌 변수에서 반환됩니다SPI_PROCESSED. 함수의 반환 값이 인 경우spi_ok_select, SPI_OK_INSERT_RETURNING, spi_ok_delete_returning또는spi_ok_update_returning, 그런 다음 글로벌 포인터를 사용할 수 있습니다spitupletable *spi_tuptable결과 행에 액세스하려면. 일부 유틸리티 명령 (예 :설명) 또한 행 세트를 반환하고SPI_TUPTable이 경우에도 결과도 포함됩니다. 일부 유틸리티 명령 (COPY, 테이블 작성) 행 세트를 반환하지 않으므로SPI_TUPTablenull이지만 여전히 처리 된 행 수를 반환합니다SPI_PROCESSED.

구조spitupletable다음과 같이 정의됩니다.

typedef struct

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

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

SPI_FINISH모든 것을 해방spitupletable현재 절차 중에 할당되었습니다. 전화를 통해 완료된 경우 특정 결과 테이블을 더 일찍 자유롭게 할 수 있습니다.SPI_FREETUPTABLE.

인수

반환 값

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

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

노트

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