受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发版本: devel

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报告。

提交更正

如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明,请使用此表单来报告文档问题。