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 作为结果值报告。)
如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明,请使用此表单来报告文档问题。