历史版本。 PostgreSQL 8.0 已结束支持。 请参阅 当前版本手册.
SPI_saveplan
SPI_saveplan — 保存一个计划
大纲
void * SPI_saveplan(void * plan)描述
SPI_saveplan 会把传入的计划(由
SPI_prepare 准备)保存到受保护、不会被
SPI_finish 和事务管理器释放的内存中,并返回指向所保存计划的指针。这让你能够在当前会话中当前过程的后续调用里重用预备计划。你可以把返回的指针保存到一个局部变量中。无论是准备计划时,还是在 SPI_execute_plan 中使用一个已准备好的计划时,都应始终检查该指针是否为
NULL。
参数
void *plan要保存的计划
返回值
指向所保存计划的指针;如果不成功则为
NULL。出错时,SPI_result 会被设置为:
SPI_ERROR_ARGUMENT如果
plan为NULL或无效SPI_ERROR_UNCONNECTED如果从未连接的过程中调用
注解
如果预备计划所引用的对象(表、函数等)之一在该会话期间被删除,那么对该计划执行 SPI_execute_plan 的结果将是不可预测的。