历史版本。 PostgreSQL 9.2 已结束支持。 2017-11-09. 请参阅 当前版本手册.
SPI_saveplan
SPI_saveplan — 保存一个计划
大纲
SPIPlanPtr SPI_saveplan(SPIPlanPtr plan)描述
SPI_saveplan 会把传入的计划(由
SPI_prepare 准备)保存到不会被
SPI_finish 或事务管理器释放的内存中,并返回指向所保存计划的指针。这让你能够在当前会话后续的过程调用中重用预备计划。
参数
SPIPlanPtrplan要保存的计划
返回值
指向所保存计划的指针;如果不成功则为
NULL。出错时,SPI_result 会被设置为:
SPI_ERROR_ARGUMENT如果
plan为NULL或无效SPI_ERROR_UNCONNECTED如果从未连接的过程中调用
注解
原始传入的计划不会被释放,因此你可能需要对其调用
SPI_freeplan,以避免在
SPI_finish 之前发生内存泄露。
在大多数情况下,SPI_keepplan 比此函数更合适,因为它基本能达到相同效果,同时无需实际复制该预备语句的数据结构。