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设置一个游标(内部的,一个入口), 该游标将执行一个SPI_prepare准备的已准备好的语句。 这个函数相当于SPI_cursor_open, 除了要传递给查询的有关参数值信息的表现不同。ParamListInfo 表示法可以方便的传递早已在该格式中可用的值。它也支持使用动态参数设置, 通过ParamListInfo中指定的hook函数。

传入参数数据将被拷贝到游标的入口,所以它在游标仍然存在时可以被释放。

参数

const char * name

入口的名字,或者是NULL让系统选择一个名字

SPIPlanPtr plan

预备语句(SPI_prepare返回的)

ParamListInfo params

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

bool read_only

true用于只读的执行

返回值

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