选择 打开 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
测试与开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0
历史版本PostgreSQL 9.1 已于 2016 年 10 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本

SPI_saveplan

SPI_saveplan — save a plan

大纲

SPIPlanPtr SPI_saveplan(SPIPlanPtr plan)

描述

SPI_saveplan 会把传入的计划(由 SPI_prepare 准备)保存到不会被 SPI_finish 或事务管理器释放的内存中,并返回 指向所保存计划的指针。这让你能够在当前会话后续的过程调用中重用 预备计划。

参数

SPIPlanPtr plan

要保存的计划

返回值

指向所保存计划的指针;如果不成功则为 NULL。出错时,SPI_result 会被 设置为:

SPI_ERROR_ARGUMENT

如果 planNULL 或无效

SPI_ERROR_UNCONNECTED

如果从未连接的过程中调用

注解

原始传入的计划不会被释放,因此你可能需要对其调用 SPI_freeplan,以避免在 SPI_finish 之前发生内存泄露。

如果预备计划所引用的对象(表、函数等)之一被删除或重新定义, 那么 SPI_execute_plan 未来的执行可能会失败, 或者返回与该计划最初指示不同的结果。

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。