2024 年 9 月 26 日: PostgreSQL 17 发布!
支持的版本:当前 (17) / 16 / 15 / 14 / 13 / 12
开发版本:devel
不支持的版本:11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0

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 数组中的每个条目都应为 ' '(如果对应的参数值非空),或 'n'(如果对应的参数值为空)。(在后一种情况下,values 中对应条目的实际值并不重要。)请注意,nulls 不是文本字符串,而只是一个数组:它不需要 '\0' 终止符。

bool read_only

true 用于只读执行

long count

要返回的最大行数,或 0 表示无限制

返回值

返回值与 SPI_execute 相同,但有以下其他可能的错误(负)结果

SPI_ERROR_ARGUMENT

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

SPI_ERROR_PARAM

如果 valuesNULLplan 是用一些参数准备的

如果成功,则设置 SPI_processedSPI_tuptable,与 SPI_execute 中相同。

提交更正

如果您在文档中发现任何不正确的地方,与您对特定功能的体验不符,或需要进一步澄清,请使用 此表格 报告文档问题。