이 문서는 지원되지 않는 버전의 PostgreSQL을위한 것입니다.
당신은에 대해 같은 페이지를 볼 수 있습니다롤 토토 : 문서 : 17 : spi_cursor_open버전 또는 위에 나열된 다른 지원 버전 중 하나입니다.

SPI_CURSOR_OPEN

이름

SPI_CURSOR_OPEN- a를 사용하여 커서를 설정하십시오 로 만든 계획SPI_PREPARE

시놉시스

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

설명

SPI_CURSOR_OPEN커서를 설정합니다 (내부적으로, 포털)에 의해 준비된 계획을 실행하는SPI_PREPARE. 매개 변수는 있습니다 해당 매개 변수와 동일한 의미SPI_EXECUTE_PLAN.

플랜을 직접 실행하는 대신 커서를 사용하여 2 개가 있습니다. 이익. 먼저, 결과 행을 몇 개에서 검색 할 수 있습니다. 시간, 많은 행을 반환하는 쿼리에 대한 메모리 오버런을 피하십시오. 둘째, 포털은 현재 절차를 오래 살 수 있습니다 ( 사실, 현재 거래가 끝날 때까지 살아갑니다). 반환 프로 시저의 발신자의 포털 이름은 반환 방법을 제공합니다. 결과적으로 행한 행.

전달 된 데이터가 커서 포털에 복사됩니다. 커서가 여전히 존재하는 동안 해방 될 수 있습니다.

인수

const char *이름

포털 이름 또는null시스템은 이름을 선택합니다

spiplanptrplan

실행 계획 (반품SPI_PREPARE)

Datum *

실제 매개 변수 값의 배열. 동일해야합니다 계획의 주장 수로 길이.

const char *널스

어떤 매개 변수를 설명하는 배열. 있어야합니다 계획의 주장 수와 같은 길이.nNULL 값을 나타냅니다 (입력무시됩니다); 공간 unnull 값을 나타냅니다 (입력유효합니다).

ifnullsisNULLtheSPI_CURSOR_OPEN매개 변수는 null입니다.

boolread_only

true읽기 전용 실행

반환 값

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