2025년 9월 25일:토토 커뮤니티 : 토토
이 문서는 지원되지 않는 PostgreSQL 버전에 대한 것입니다.
당신은 다음과 같은 페이지를 보고 싶을 수도 있습니다.롤 토토 : 문서 : 17 : spi_cursor_open버전 또는 위에 나열된 다른 지원 버전 중 하나를 사용하세요.

SPI_cursor_open

이름

SPI_cursor_open - 다음을 사용하여 커서를 설정합니다. 다음을 사용하여 만든 계획SPI_prepare

시놉시스

포털 SPI_cursor_open(const char *이름, SPIPlanPtr계획,
                       데이텀 *, const char *,
                       부울읽기 전용)

설명

SPI_cursor_open커서를 설정합니다 (내부적으로는 포털)에서 준비한 계획을 실행하게 됩니다.SPI_prepare. 매개변수는 해당 매개변수와 동일한 의미SPI_execute_plan.

계획을 직접 실행하는 대신 커서를 사용하면 두 가지 혜택. 첫째, 결과 행을 한 번에 여러 개 검색할 수 있습니다. 많은 행을 반환하는 쿼리에 대한 메모리 오버런을 방지합니다. 둘째, 포털은 현재 절차보다 오래 지속될 수 있습니다. 사실, 현재 거래가 끝날 때까지 살아 있음). 반환 프로시저 호출자에 대한 포털 이름은 반환 방법을 제공합니다. 결과로 설정된 행입니다.

전달된 데이터는 커서의 포탈에 복사될 것입니다. 커서가 여전히 존재하는 동안 해제될 수 있습니다.

인수

상수 문자 *이름

포털 이름 또는NULL내버려두다 시스템에서 이름을 선택합니다.

SPIPlanPtr계획

실행 계획(반환자:SPI_prepare)

데이텀 *

실제 매개변수 값의 배열. 동일해야 함 길이를 계획의 인수 수로 설정합니다.

상수 문자 *

어떤 매개변수가 null인지 설명하는 배열입니다. 있어야 한다 계획의 인수 수와 길이가 같습니다.n널 값을 나타냅니다(입력 항목무시됩니다); 공간 Null이 아닌 값을 나타냅니다(입력 항목유효함).

만약이다NULL그런 다음SPI_cursor_open그렇지 않다고 가정합니다. 매개변수가 null입니다.

부울읽기 전용

사실읽기 전용의 경우 실행

반환 값

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