SPI_CURSOR_OPEN

SPI_CURSOR_OPEN - |SPI_PREPARE

시놉시스

포털 SPI_CURSOR_OPEN (const char *이름, spiplanptrplan,
                       데이텀 *, const char *nulls,
                       boolread_only)

설명

spi_cursor_open|SPI_PREPARE. 매개 변수는 해당 매개 변수와 동일한 의미를 갖습니다.SPI_EXECUTE_PLAN.

명령문을 직접 실행하는 대신 커서를 사용하면 두 가지 이점이 있습니다. 먼저, 결과 행을 한 번에 몇 개 씩 검색하여 많은 행을 반환하는 쿼리에 대한 메모리 오버런을 피할 수 있습니다. 둘째, 포털은 현재 C 함수를 오래 살 수 있습니다 (실제로 현재 트랜잭션의 끝까지 살 수 있음). C 함수의 발신자에게 포털 이름을 반환하면 결과적으로 행 세트를 반환하는 방법이 제공됩니다.

전달 된 매개 변수 데이터가 커서 포털에 복사되므로 커서가 여전히 존재하는 동안 해제 될 수 있습니다.

인수

const char *이름

포털 이름 또는NULL시스템이 이름을 선택하도록하려면

spiplanptrplan

준비된 진술 (반품SPI_PREPARE)

Datum *

실제 매개 변수 값의 배열. 성명서의 인수 수와 같은 길이가 있어야합니다.

const char *널스

어떤 매개 변수를 설명하는 배열. 성명서의 인수 수와 같은 길이가 있어야합니다.

ifnullsisNULLtheSPI_CURSOR_OPEN매개 변수가 무효라고 가정합니다. 그렇지 않으면,의 각 항목nulls배열이' '해당 매개 변수 값이 NULL 인 경우'n'해당 매개 변수 값이 NULL 인 경우. (후자의 경우 해당의 실제 값항목은 중요하지 않습니다.) 참고널스텍스트 문자열이 아니라 배열 일뿐입니다.'\ 0'터미네이터.

boolread_only

true읽기 전용 실행

반환 값

커서를 포함하는 포털에 대한 포인터. 오류 반환 규칙이 없습니다. 모든 오류는를 통해보고됩니다.elog.

정정 제출

올바르지 않은 문서에 아무것도 표시되면 일치하지 않습니다. 특정 기능에 대한 귀하의 경험 또는 추가 설명이 필요합니다. 사용이 양식문서 문제를보고하려면