支持的版本:当前 (17) / 16 / 15 / 14 / 13
开发版本:devel
不支持的版本:12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0

SPI_cursor_open_with_paramlist

SPI_cursor_open_with_paramlist — 使用参数设置游标

概要

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

提交更正

如果您在文档中看到任何不正确、与您使用特定功能的体验不符或需要进一步澄清的内容,请使用此表单报告文档问题。