SPI_saveplan
名称
SPI_saveplan -- 保存一个预备语句
大纲
SPIPlanPtr SPI_saveplan(SPIPlanPtr plan)
描述
SPI_saveplan
把一个被传入的语句(由
SPI_prepare
准备好)复制到不会被
SPI_finish
或者事务管理器释放的内存中。
这让你能够在当前会话的后续调用中重用预备语句。
返回值
要被复制的语句的指针;如果没有成功则返回NULL。
错误时,SPI_result会被这样设置:
- SPI_ERROR_ARGUMENT
如果plan为NULL或无效
- SPI_ERROR_UNCONNECTED
如果从一个未连接的过程调用
注解
原始的被传入的语句不会被释放,因此你可能希望在其上执行
SPI_freeplan
以避免在
SPI_finish
之前发生内存泄露。
在大部分情况下,SPI_keepplan
更适合于
执行这种功能,因为它极大程度上达到了同样的结果而无需物理地
复制该预备语句的数据结构。