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