Redrock Postgres 搜索 英文
版本: 9.3 / 9.4 / 9.5 / 9.6 / 10 / 11 / 12 / 13 / 14 / 15 / 16 / 17 / 18

SPI_cursor_open_with_paramlist

SPI_cursor_open_with_paramlist — 使用参数建立一个游标

Synopsis

Portal SPI_cursor_open_with_paramlist(const char *name,
                                      SPIPlanPtr plan,
                                      ParamListInfo params,
                                      bool read_only)

描述

SPI_cursor_open_with_paramlist 建立一个游标 (内部即一个 portal),用来执行由 SPI_prepare 准备好的语句。它相当于 SPI_cursor_open,只是向查 询传递参数值的方式不同。ParamListInfo 表示形式便于传 递已经按这种格式存在的值,也支持通过 ParamListInfo 中指定的钩子函数使用动态参数集。

传入的参数数据会被复制到该游标的 portal 中,因此即使该游标仍然存在, 也可以释放这些参数数据。

参数

const char * name

portal 的名称,或为NULL以让系统选择名称

SPIPlanPtr plan

预备语句(由SPI_prepare返回)

ParamListInfo params

包含参数类型和值的数据结构;没有参数时为 NULL

bool read_only

true 表示只读执行

返回值

指向包含该游标的 portal 的指针。注意这里没有错误返回约定, 任何错误都将通过elog报告。