SPI_EXECUTE_EXTENDEND-외부 매개 변수로 명령을 실행
int spi_execute_extended (const char *명령, const spiexecuteoptions *옵션)
spi_execute_extended외부에서 제공되는 매개 변수에 대한 참조가 포함될 수있는 명령을 실행합니다. 명령 텍스트는 매개 변수를라고합니다.$및n옵션- 매개 변수개체 (제공된 경우)는 그러한 각 기호에 대한 값과 유형 정보를 제공합니다. 다양한 실행 옵션을에 지정할 수 있습니다.옵션struct,
the옵션- 매개 변수개체는 일반적으로 각 매개 변수를에 표시해야합니다.param_flag_const플래그, 원샷 계획은 항상 쿼리에 사용되므로
if옵션- destnull이 아닙니다. 그런 다음 튜플이 executor에 의해 생성 될 때 해당 물체로 전달됩니다.spi_tuptable. 발신자 제공 사용Destreceiver객체는 메모리에 축적되는 대신 데이터를 날아가는 대신에 데이터를 처리 할 수 있기 때문에 많은 튜플을 생성 할 수있는 쿼리에 특히 도움이됩니다..
const char *명령명령 문자열
const spiexecuteoptions *옵션선택적 인수를 포함하는 구조
발신자는 항상 전체를 제로로 제로해야합니다옵션struct를 작성하고 원하는 필드를 채우십시오. 이는 향후 구조물에 추가 된 필드가 0 인 경우 호환 적으로 거꾸로 행동하도록 정의되므로 코드의 전진 호환성을 보장합니다. 현재 사용 가능한옵션필드는 다음과 같습니다.
ParamlistInfoparams쿼리 매개 변수 유형 및 값을 포함하는 데이터 구조; null if none
boolread_onlytrue읽기 전용 실행
boolallow_nonatomictrue비 원자의 통화 및 DO 문을 허용합니다 (그러나이 필드는이면 무시됩니다SPI_OPT_NONATOMIC플래그가 전달되었습니다SPI_CONNECT_EXT)
boolmust_return_tuplesiftrue, 쿼리가 튜플을 반환하는 종류가 아닌 경우 오류를 올리십시오 (제로 튜플을 반환하는 경우 케이스를 금지하지 않습니다)
UINT64tcount반환 할 최대 행 수, 또는0한계 없음
Destreceiver *destDestreceiver쿼리에 의해 방출되는 튜플을받을 객체; null이면 결과 튜플이 a에 축적됩니다.spi_tuptable구조,SPI_EXECUTE
자원 소유자소유자이 필드는와 일관성을 위해 존재합니다spi_execute_plan_extended, 그러나 이후 이후 무시됩니다.spi_execute_extended절대 저장되지 않았습니다.
반환 값은와 동일합니다SPI_EXECUTE.
언제옵션- destis null,SPI_PROCESSEDandSPI_TUPTableSPI_Execute. 언제옵션- destin is null,SPI_PROCESSED0으로 설정되어SPI_TUPTable는 null로 설정되었습니다. 튜플 카운트가 필요한 경우 발신자의Destreceiver객체를 계산해야합니다.