SPI_execute_plan
Name
SPI_execute_plan -- 执行一个
SPI_prepare 准备的查询规划
Synopsis
int SPI_execute_plan(void * plan, Datum * values, const char * nulls,
bool read_only, long count)描述
SPI_execute_plan 执行一个 SPI_prepare 准备的规划。
read_only 和 count 的含义和 SPI_execute 里面的相同。
参数
- void * plan
执行规划（SPI_prepare 返回的东西）
- Datum *values
一个实际的参数值的数组。比如和规划的参数个数长度相同。
- const char * nulls
一个描述哪个参数是空的数组。必须和规划的参数个数相同。
n 表示一个空值（在 values 里面对应的条目将被忽略）；
一个空格表示一个非空值（在 values 里对应条目是有效的）。
如果 nulls 是 NULL，那么 SPI_execute_plan 就认为没有参数是空。
- bool read_only
只读执行时为 true
- long count
执行或返回的最大行数
返回值
返回值和 SPI_execute 的一样，另外还有下面几个可能的（负值）结果：
- SPI_ERROR_ARGUMENT
如果 plan 是 NULL 或者 count 小于 0
- SPI_ERROR_PARAM
如果 values 是 NULL 而 plan 准备了一些参数
成功时，
SPI_processed 和
SPI_tuptable 的设置和
SPI_execute 里一样。
注意
如果准备好了的规划引用的一个对象（表，函数，等等。）在会话过程中被删除，
那么 SPI_execute_plan 对此规划的执行结果将不可预料。