PostgreSQL 18 文档: SPI_execute_plan_with_paramlist

SPI_execute_plan_with_paramlist
上一步	上一级	45.1. 接口函数	首页	下一步

SPI_execute_plan_with_paramlist

SPI_execute_plan_with_paramlist — 执行由 SPI_prepare 准备的语句

概要

int SPI_execute_plan_with_paramlist(SPIPlanPtr plan,
                                    ParamListInfo params,
                                    bool read_only,
                                    long count)

描述

SPI_execute_plan_with_paramlist 执行由 SPI_prepare 准备的语句。此函数等同于 SPI_execute_plan，只是传递给查询的参数值信息以不同的方式呈现。ParamListInfo 格式在传递已以该格式准备好的值时可能很方便。它还支持通过 ParamListInfo 中指定的钩子函数使用动态参数集。

此函数现已弃用，推荐使用 SPI_execute_plan_extended。

参数

SPIPlanPtr plan: 已准备好的语句（由 SPI_prepare 返回）
ParamListInfo params: 包含参数类型和值的结构体；如果没有参数则为 NULL
bool read_only: 只读执行时为 true
long count: 要返回的最大行数，或 0 表示无限制

返回值

返回值与 SPI_execute_plan 相同。

如果成功，SPI_processed 和 SPI_tuptable 的设置与 SPI_execute_plan 相同。