2025年9月25日: PostgreSQL 18 釋出!
支援的版本: 當前 (18) / 17 / 16 / 15 / 14 / 13
開發版本: devel
不支援的版本: 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

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 連線設定為非原子,這意味著允許事務控制呼叫(SPI_commitSPI_rollback)。否則,呼叫這些函式將導致立即出錯。

SPI_connect() 等同於 SPI_connect_ext(0)

返回值

SPI_OK_CONNECT

成功時

這些函式返回 int 而不是 void 是歷史原因。所有失敗情況都透過 ereportelog 報告。(在 PostgreSQL v10 之前的版本中,部分但並非全部失敗會以 SPI_ERROR_CONNECT 的返回值報告。)

提交更正

如果您在文件中看到任何不正確、與您對特定功能的使用經驗不符或需要進一步澄清的內容,請使用 此表單 報告文件問題。