SPI_execute_plan

名称

SPI_execute_plan -- 执行一个SPI_prepare准备的语句

大纲

int SPI_execute_plan(SPIPlanPtr plan, Datum * values, const char * nulls,
                     bool read_only, long count)

描述

SPI_execute_plan执行一个SPI_prepare 或它的兄弟节点之一准备的语句。read_onlycount的含义和SPI_execute里面的相同。

参数

SPIPlanPtr plan

预备语句(SPI_prepare返回的)

Datum * values

一个实际的参数值的数组。必须和语句的参数个数相同。

const char * nulls

一个描述哪个参数是空的数组。必须和语句的参数个数相同。

如果nullsNULL,那么SPI_execute_plan 假设没有参数为空。否则,如果对应的参数值是非空的,那么nulls 数组的每一项都应该是' ',或者如果对应的参数值为空,那么 nulls数组的每一项都是'n'。 (在后面这种情况下,对应的values项中的实际值无关紧要。) 请注意,nulls不是文本字符串,只是一个数组: 它不需要'\0'终止符。

bool read_only

true用于只读的执行

long count

返回的最大行数,或者没有限制时为0

返回值

返回值和SPI_execute的一样,另外还有下面几个可能的错误(负值)结果:

SPI_ERROR_ARGUMENT

如果planNULL或者无效, 或者count小于 0

SPI_ERROR_PARAM

如果valuesNULL并且 plan准备了一些参数

成功时,SPI_processedSPI_tuptable 的设置和SPI_execute里一样。