历史版本。 PostgreSQL 9.4 已结束支持。 2020-02-13. 请参阅 当前版本手册.
SPI_prepare_cursor
SPI_prepare_cursor — 准备一个语句,但暂不执行
大纲
SPIPlanPtr SPI_prepare_cursor(const char *command, intnargs, Oid *argtypes, intcursorOptions)
描述
SPI_prepare_cursor 与
SPI_prepare 相同,但额外允许指定规划器的“游标选项”参数。该参数是一个位掩码,其可取值对应于
nodes/parsenodes.h 中
DeclareCursorStmt 的
options 字段。SPI_prepare
总是把游标选项设为零。
参数
const char *command命令字符串
intnargs输入参数的数量(
$1、$2等)Oid *argtypes一个数组指针,它指向的数组包含参数的数据类型的 OID
intcursorOptions整数形式的游标选项位掩码,零会导致默认行为
返回值
SPI_prepare_cursor 的返回约定与
SPI_prepare 相同。
注解
适合在 cursorOptions 中设置的位包括
CURSOR_OPT_SCROLL、CURSOR_OPT_NO_SCROLL、CURSOR_OPT_FAST_PLAN、CURSOR_OPT_GENERIC_PLAN 和
CURSOR_OPT_CUSTOM_PLAN。需要特别注意的是,CURSOR_OPT_HOLD 会被忽略。