↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
测试与开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4
历史版本PostgreSQL 8.4 已于 2014 年 7 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本。

SPI_execute_with_args

SPI_execute_with_args — 执行使用外部参数的命令

大纲

int SPI_execute_with_args(const char *command,
                          int nargs, Oid *argtypes,
                          Datum *values, const char *nulls,
                          bool read_only, long count)

描述

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

一个数组,包含各参数数据类型的 OID

Datum * values

一个实际参数值的数组

const char * nulls

一个描述哪些参数为空值的数组

如果 nulls 为 NULL,则 SPI_execute_with_args 假定没有参数为空值。

bool read_only

true 表示只读执行

long count

要处理或返回的最大行数

返回值

返回值与 SPI_execute 相同。

成功时,SPI_processed 和 SPI_tuptable 的设置方式与 SPI_execute 相同。

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。