Postgresql 中文操作指南

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)

Description

SPI_cursor_open_with_paramlist 设置一个光标（内部门户）以执行 SPI_prepare 准备好的语句。 此函数等同于 SPI_cursor_open ，但传入查询的参数值的的信息呈现不同。 ParamListInfo 表示对于传入该格式的值非常方便。 它也支持通过 ParamListInfo 中指定挂接函数使用动态参数集。

传入的参数数据将被复制到光标的门户中，因此可在光标仍然存在时释放它。

Arguments

  • const char * _name_

    • * 门户名称，或 NULL 以让系统选择名称

  • SPIPlanPtr _plan_

    • * 已准备好的语句（由 SPI_prepare 返回）

  • ParamListInfo _params_

    • * 包含参数类型和值的数据结构；如果为无，则为 NULL

  • bool _read_only_

    • true for read-only execution

Return Value

  • 指向包含光标的门户。请注意，没有错误返回约定；任何错误将通过 elog 报告。