历史版本。 PostgreSQL 9.2 已结束支持。 2017-11-09. 请参阅 当前版本手册.
SPI_execute_with_args
SPI_execute_with_args — 执行使用外部参数的命令
大纲
int SPI_execute_with_args(const char *command, intnargs, Oid *argtypes, Datum *values, const char *nulls, boolread_only, longcount)
描述
SPI_execute_with_args 执行一条可能包含外部提供参数引用的命令。命令文本中的参数引用写作
$，而该调用会为每个这类符号指定数据类型和值。nread_only 和
count 的含义与
SPI_execute 中相同。
相比 SPI_execute，这个例程的主要优点在于可将数据值插入命令而无需繁琐的引用和转义，因此能够显著降低 SQL 注入攻击的风险。
也可以通过先调用 SPI_prepare，再调用
SPI_execute_plan 达到类似效果。不过，使用本函数时，查询计划会针对所提供的具体参数值进行定制。对于一次性查询执行，应优先选择本函数。如果同一条命令要用许多不同参数重复执行，则两种方式孰快取决于重新规划的代价与定制计划收益之间的权衡。
参数
const char *command命令字符串
intnargs输入参数的数量（
$1、$2等）Oid *argtypes一个数组，包含各参数数据类型的 OID
Datum *values一个实际参数值的数组
const char *nulls一个描述哪些参数为空值的数组
如果
nulls为NULL，则SPI_execute_with_args假定没有参数为空值。boolread_onlytrue表示只读执行longcount要返回的最大行数，或者用
0表示不限制
返回值
返回值与 SPI_execute 相同。
成功时，SPI_processed 和
SPI_tuptable 的设置方式与
SPI_execute 相同。