Name
SPI_saveplan -- 保存一个传入的规划
Synopsis
SPI_saveplan(
plan
)
输出
-
void *
-
执行规划位置．如果不成功则为 NULL．
-
SPI_result
-
|
如果规划为 NULL 为
SPI_ERROR_ARGUMENT
． |
|
如果过程未连接则返回
SPI_ERROR_UNCONNECTED
． |
描述
SPI_saveplan
将一个
SPI_prepare
准备的规划保存在
安全的内存中，以保护它不被
SPI_finish
或者
事务管理器释放．
目前的
PostgreSQL
还没有能力在系统
表里存储已准备的规划，并且在它们执行的时候抓取它们．
这个特性将在未来的版本中实现．
一种弥补的办法是我们可以在当前会话过程中的随后的调用中
复用已准备的规划．使用
SPI_execp
执行这样的
已保存好的规划．
用法
SPI_saveplan
把一个传入的规划
(由
SPI_prepare
准备)保存到可以防止
SPI_finish
和事务管理器释放的内存中，
并且返回一个指向这个已保存规划的指针．你可以在一个本地变量中
保存这个返回的指针．不管你是在准备一个规划还是在 SPI_execp(见下文)
里使用一个已准备的规划，你都要检查该指针是否为 NULL．
注意:
如果在你的会话过程中有一个已准备规划引用的对象(一个关系，函数等等)
被删除(由你的后端或者其它进程删除)，那么
SPI_execp
执行这个规划所产生的结果将不可预料．
|