pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。
SPI_finish(void)
无
→ SPI_OK_FINISH 已正确断开连接时 |
→ SPI_ERROR_UNCONNECTED 从未连接的过程中调用时 |
SPI_finish 关闭到 Postgres 后端的现有连接。 在完成通过 SPI 管理器所做的操作之后,就应调用此函数。
如果在当前没有有效连接的情况下调用 SPI_finish, 可能会得到错误返回 → SPI_ERROR_UNCONNECTED。 这并不是什么根本性的问题;它只表示 SPI 管理器没有做任何事情。
已连接的过程必须以调用 SPI_finish 作为最后一步,否则可能得到不可预 测的结果!注意,如果你中止了事务(通过 elog(ERROR)),则可以安全地 跳过对 SPI_finish 的调用。
SPI_finish 执行以下操作:
将你的过程与 SPI 管理器断开连接,并释放该过程自 SPI_connect 以来通过 palloc 所做的全部内存分配。这些分配不能再使用了!参见内存管理。
译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。