On this page
SPI_saveplan
SPI_saveplan —保存准备好的语句
Synopsis
SPIPlanPtr SPI_saveplan(SPIPlanPtr plan)
Description
SPI_saveplan
将传递的语句(由SPI_prepare
准备)复制到SPI_finish
或事务 Management 器都不会释放的内存中,并返回指向复制的语句的指针。这使您能够在当前会话的过程的后续调用中重用准备好的语句。
Arguments
SPIPlanPtr plan
- 准备好的要保存的语句
Return Value
指向复制语句的指针;或NULL
(如果不成功)。如果出错,则设置SPI_result
:
SPI_ERROR_ARGUMENT
- 如果*
plan
*为NULL
或无效
- 如果*
SPI_ERROR_UNCONNECTED
- 如果从未连接的过程调用
Notes
最初传入的语句不会释放,因此您可能希望对其执行SPI_freeplan
以避免在SPI_finish
之前泄漏内存。
在大多数情况下,此函数首选SPI_keepplan
,因为它可以实现几乎相同的结果,而无需物理复制准备好的语句的数据结构。