历史版本。 PostgreSQL 11 已结束支持。 2023-11-09. 请参阅 当前版本手册.
SPI_execute_plan
SPI_execute_plan — 执行由 SPI_prepare 准备好的语句
大纲
int SPI_execute_plan(SPIPlanPtrplan, Datum *values, const char *nulls, boolread_only, longcount)
描述
SPI_execute_plan 执行由 SPI_prepare
或其同类函数准备好的语句。read_only 和
count 的含义与
SPI_execute 中相同。
参数
SPIPlanPtrplan预备语句（由
SPI_prepare返回）Datum *values一个实际参数值的数组。必须和语句的参数数量等长。
const char *nulls一个描述哪些参数为空值的数组。必须和语句的参数数量等长。
如果
nulls为NULL，则SPI_execute_plan会假定没有参数为空值。否则，如果对应参数值非空值，则nulls数组中的对应项应为' '；如果对应参数值为空值，则对应项应为'n'。（后一种情况下，对应values项中的实际值无关紧要。）注意，nulls不是文本字符串，而只是一个数组，因此不需要'\0'终止符。boolread_onlytrue表示只读执行longcount要返回的最大行数，或者用
0表示不限制
返回值
返回值和 SPI_execute 相同，还有下列额外可能的错误（负值）结果：
SPI_ERROR_ARGUMENT如果
plan为NULL或者非法，或者count小于 0SPI_ERROR_PARAM如果
values为NULL，但plan在准备时带有参数
成功时，SPI_processed 和
SPI_tuptable 的设置方式与
SPI_execute 相同。