SPI_cursor_open — 생성된 명령문을 사용하여 커서를 설정합니다.SPI_prepare
포털 SPI_cursor_open(const char *이름, SPIPlanPtr계획, 데이텀 *값, const char *104PostgreSQL: 문서: 18: SPI_cursor_open50, 부울읽기 전용)
SPI_cursor_open다음에 의해 준비된 명령문을 실행할 커서(내부적으로 포털)를 설정합니다.SPI_prepare. 매개변수는 해당 매개변수와 동일한 의미를 갖습니다.SPI_execute_plan.
문을 직접 실행하는 대신 커서를 사용하면 두 가지 이점이 있습니다. 첫째, 결과 행을 한 번에 몇 개씩 검색할 수 있으므로 많은 행을 반환하는 쿼리의 메모리 오버런을 방지할 수 있습니다. 둘째, 포털은 현재 C 기능보다 오래 지속될 수 있습니다(실제로 현재 트랜잭션이 끝날 때까지 지속될 수 있습니다). C 함수 호출자에게 포털 이름을 반환하면 결과로 행 집합을 반환하는 방법이 제공됩니다.
전달된 매개변수 데이터는 커서의 포털에 복사되므로 커서가 여전히 존재하는 동안 해제될 수 있습니다.
상수 문자 *이름포털 이름 또는NULL시스템이 이름을 선택하도록 함
SPIPlanPtr계획준비된 명령문(반환자:SPI_prepare)
데이텀 *값실제 매개변수 값의 배열. 문의 인수 개수와 길이가 동일해야 합니다.
상수 문자 *널어떤 매개변수가 null인지 설명하는 배열. 문의 인수 개수와 길이가 동일해야 합니다.
만약널isNULL그런 다음SPI_cursor_open매개변수가 null이 아닌 것으로 가정합니다. 그렇지 않으면,의 각 항목은널배열은 다음과 같아야 합니다' '해당 매개변수 값이 null이 아닌 경우, 또는'n'해당 매개변수 값이 null인 경우. (후자의 경우 해당하는 실제 값값항목은 중요하지 않습니다.) 참고널텍스트 문자열이 아니며 단지 배열입니다. 필요하지 않습니다.'\0'터미네이터.
부울읽기 전용참읽기 전용 실행용
커서를 포함하는 포털에 대한 포인터. 오류 반환 규칙은 없습니다. 모든 오류는 다음을 통해 보고됩니다.elog.
문서에 올바르지 않은 내용이 있으면 일치하지 않습니다. 특정 기능에 대한 경험이 있거나 추가 설명이 필요한 경우 이용해주세요이 양식문서 문제를 보고합니다.