↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4
开发快照。 PostgreSQL 20devel 尚未正式发布,内容仍可能变化。

SPI_connect

SPI_connect, SPI_connect_ext — 将一个 C 函数连接到 SPI 管理器

大纲

int SPI_connect(void)
int SPI_connect_ext(int options)

描述

SPI_connect 会为某次 C 函数调用打开到 SPI 管理器的连接。如果要通过 SPI 执行命令,就必须调用此函数。不过,有些 SPI 辅助函数可以在未连接的 C 函数中调用。

SPI_connect_ext 执行相同的操作,但多了一个可传递选项标志的参数。目前可用的选项值如下:

SPI_OPT_NONATOMIC

将 SPI 连接设为非原子(nonatomic),这意味着允许进行事务控制调用(SPI_commit、SPI_rollback)。否则,调用这些函数会立即报错。

SPI_connect() 等价于 SPI_connect_ext(0)。

返回值

SPI_OK_CONNECT

成功时

这些函数返回 int 而不是 void 属于历史遗留设计。所有失败情况都通过 ereport 或 elog 报告。(在 PostgreSQL v10 之前,部分但并非全部失败会以 SPI_ERROR_CONNECT 作为结果值报告。)

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.