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
执行一个可能包含对外部提供的参数引用的命令。命令文本将参数引用为 $
,并且调用指定了每个此类符号的数据类型和值。n
read_only
和 count
与 SPI_execute
中的含义相同。
与 SPI_execute
相比,此例程的主要优点是可以将数据值插入到命令中,而无需进行繁琐的引用/转义,从而大大降低 SQL 注入攻击的风险。
可以使用 SPI_prepare
后跟 SPI_execute_plan
来实现类似的结果;但是,当使用此函数时,查询计划始终根据提供的特定参数值进行定制。对于一次性查询执行,应优先使用此函数。如果要使用许多不同的参数执行相同的命令,则这两种方法可能都更快,具体取决于重新规划的成本与自定义计划的益处的权衡。
const char * command
命令字符串
int nargs
输入参数的数量($1
,$2
等)
Oid * argtypes
一个长度为 nargs
的数组,包含OID参数数据类型的
Datum * values
一个长度为 nargs
的数组,包含实际的参数值
const char * nulls
一个长度为 nargs
的数组,描述哪些参数为 null
如果 nulls
为 NULL
,则 SPI_execute_with_args
假设没有参数为 null。否则,nulls
数组的每个条目都应为 ' '
(如果对应的参数值非 null),或 'n'
(如果对应的参数值为空)。(在后一种情况下,values
中对应条目的实际值无关紧要。)请注意,nulls
不是文本字符串,而只是一个数组:它不需要 '\0'
终止符。
bool read_only
true
表示只读执行
long count
要返回的最大行数,或 0
表示没有限制
返回值与 SPI_execute
相同。
SPI_processed
和 SPI_tuptable
在成功时设置为与 SPI_execute
中相同。
如果您在文档中看到任何不正确的内容,与您对特定功能的体验不符,或者需要进一步澄清,请使用此表单报告文档问题。