| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Fast Forward | Next | |
SPI_prepare에 의해 준비된 계획에 필요하게 되는 인자의 수를 돌려준다SPI_prepare로 준비된 계획으로 지정되는 인자의 데이터형의 OID를 돌려준다.SPI_prepare로 준비된 계획이 SPI_cursor_open
로 사용될 수 있는 경우에 true를 돌려준다.SPI_prepare로 준비된 계획을 실행한다SPI_prepare로 작성된 계획을 사용한 커서를 설정한다SPI_execute나 유사한 함수에 의해 생성된 행 세트를 해제한다서버 프로그래밍 인터페이스(SPI)는, 사용자 정의의 C함수로부터 SQL쿼리 실행하는 기능을 사용자에게 제공합니다. SPI는 파서, 플래너, 집행자에의 접속을 단순화 한 인터페이스 함수의 집합입니다. 또, SPI는 메모리 관리를 실시합니다.
Note: 이용 가능한 수속 언어는, 프로시저로부터 SQL 명령을 실행하기 위한 각종 수단을 제공합니다. 이러한 대부분은, SPI를 바탕으로 하고 있기 때문에, 이 문서는 이러한 언어의 사용자에 있어서도 유용한 경우가 있습니다.
오해를 막기 위해서, 이 이후, "함수"를 SPI인터페이스 함수의 의미로, "프로시저"를 SPI를 호출하는 사용자 정의의 C함수의 의미로 사용하기로 하겠습니다.
명령이 SPI의 실패를 일으켰을 경우, 그 제어는 프로시저에는 돌아오지 않는 것에 주의해 주세요. 그 뿐만 아니라, 프로시저를 실행하고 있던 트랜잭션 혹은 서브트랜잭션은 롤백(rollback) 됩니다 (이것은 SPI 함수의 대부분으로 에러를 돌려주는 규약이 있는 것으로부터 이상하게 생각될지도 모릅니다. 그러나, 이러한 규약은 SPI 함수 자신으로 에러를 감지했을 때에게만 적용되는 것입니다). 실패할 가능성이 있는 SPI 호출을 둘러싸는 서브트랜잭션을 독자적으로 준비하는 것으로, 에러 후의 제어를 되돌릴 수가 있습니다. 요구되는 기법이 아직 유동적이기 때문에, 이것은 아직 문서화 되고 있지 않습니다.
SPI함수는 성공시에 부가 아닌 결과를(반환값, 혹은 후술의SPI_result글로벌 변수안에) 돌려줍니다. 에러시, 부의 결과 혹은 NULL를 돌려줍니다.
SPI를 사용하는 소스 코드 파일에서는 executor/spi.h헤더 파일을 포함하지 않으면 안됩니다.