int 토토 사이트 (const char *명령, boolread_only, Longcount)

설명

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

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

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

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

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

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

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

토토 사이트 ( "foo에 삽입 * 삽입 *에서 * Bar returning *", False, 5);

최대 5 개의 행이 삽입됩니다.반환결과 행 검색.

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

언제read_onlyisfalse,토토 사이트명령 카운터를 증가시키고 새로 계산합니다Snapshot문자열에서 각 명령을 실행하기 전에. 현재 트랜잭션 격리 레벨이 인 경우 스냅 샷이 실제로 변경되지 않습니다.SERIALIZALE또는반복 가능한 읽기하지만Commited 읽기모드 스냅 샷 업데이트를 통해 각 명령은 다른 세션에서 새로 커밋 된 트랜잭션의 결과를 볼 수 있습니다. 명령이 데이터베이스를 수정하는 경우 일관된 동작에 필수적입니다.

언제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 spitupletable

필드Tupdesc,vals및numvalsSPI 발신자가 사용할 수 있습니다. 나머지 필드는 내부입니다.vals는 행에 대한 많은 포인터 배열입니다. 행의 수는에 의해 제공됩니다.numvals(다소 역사적 이유로,이 카운트도 반환됩니다SPI_PROCESSED).Tupdesc행을 다루는 SPI 기능으로 전달할 수있는 행 디스크립터입니다.

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

인수

반환 값

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

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

노트

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