이 문서는 지원되지 않는 버전의 와이즈 토토을위한 것입니다.
당신은에 대해 같은 페이지를 보려고 할 수 있습니다토토 : 문서 : 17 : SPI_PREPARE버전 또는 위에 나열된 다른 지원 버전 중 하나입니다.

SPI_PREPARE

이름

SPI_PREPARE- 계획 준비 아직 실행하지 않고 명령

시놉시스

spiplanptr spi_prepare (const char *명령, intNARGS, oid *Argtypes)

설명

SPI_PREPARE생성 및 반환 지정된 명령에 대한 실행 계획이지만 실행되지 않습니다. 명령. 이 기능은 연결된 것만으로 호출해야합니다 절차.

동일하거나 유사한 명령을 실행하는 경우 반복적으로 계획 만 수행하는 것이 유리할 수 있습니다. 한 번.SPI_PREPARE변환 a 실행할 수있는 실행 계획에 명령 문자열 반복적으로 사용SPI_EXECUTE_PLAN.

준비된 명령은 매개 변수를 작성하여 일반화 할 수 있습니다 ($ 1, $ 2등) 정상적인 명령에서 상수가 될 대신. 그만큼 그런 다음 매개 변수의 실제 값은에 지정됩니다.SPI_EXECUTE_PLAN호출됩니다. 이것 준비된 명령을 더 넓은 범위의 매개 변수없이 가능한 상황.

계획은SPI_PREPARE현재 절차의 호출에만 사용할 수 있습니다. 부터SPI_FINISH메모리를 해방시킵니다 계획에 할당되었습니다. 그러나 더 오래 사용하기 위해 계획을 저장할 수 있습니다 함수SPI_SAVEPLAN.

인수

const char *명령

명령 문자열

intNARGS

입력 매개 변수 수 ($ 1, $ 2등)

OID *Argtypes

배열을 포함하는 배열에 대한 포인터OID매개 변수

반환 값

SPI_PREPARE널을 반환합니다 실행 계획에 대한 포인터. 오류로NULL반환되고SPI_RESULT동일한 오류 중 하나로 설정됩니다 사용 코드SPI_EXECUTESPI_ERROR_ARGUMENTif명령isNULL또는 ifNARGSis 0 미만 또는 ifNARGS더 큽니다 0과ArgtypesisNULL.

노트

spiplanptr는 포인터로 선언됩니다 불투명 한 구조물 유형SPI.H. 그것은 내용에 직접 액세스하려고하지 않으려 고 향후 |와이즈 토토.

매개 변수 사용에 대한 단점이 있습니다 : 플래너 이후 제공 될 값을 모릅니다. 매개 변수, 그것은 계획보다 더 나쁜 계획을 만들 수 있습니다. 모든 상수가 보이는 정상 명령을 내립니다.