postgres_fdw 在第一次查詢使用與外部伺服器關聯的外部表時建立到外部伺服器的連線。預設情況下，此連線會保持開啟狀態並在同一會話的後續查詢中重用。此行為可以透過外部伺服器的 keep_connections 選項來控制。如果使用多個使用者身份（使用者對映）訪問外部伺服器，則為每個使用者對映建立一個連線。

更改外部伺服器或使用者對映的定義或刪除它們時，相關的連線會被關閉。但請注意，如果任何連線在當前本地事務中使用，則會保留到事務結束。關閉的連線將在將來的查詢使用外部表時重新建立。

一旦建立了到外部伺服器的連線，預設情況下它會一直保持開啟狀態，直到本地或相應的遠端會話退出。要顯式斷開連線，可以停用外部伺服器的 keep_connections 選項，或者使用 postgres_fdw_disconnect 和 postgres_fdw_disconnect_all 函式。例如，這些對於關閉不再需要的連線很有用，從而釋放外部伺服器上的連線。

在引用外部伺服器上任何遠端表的查詢期間，如果當前本地事務還沒有對應的遠端事務，postgres_fdw 會在遠端伺服器上開啟一個事務。當本地事務提交或中止時，遠端事務也會相應地提交或中止。儲存點也以類似的方式進行管理，透過建立相應的遠端儲存點。

當本地事務具有 SERIALIZABLE 隔離級別時，遠端事務使用 SERIALIZABLE 隔離級別；否則，它使用 REPEATABLE READ 隔離級別。此選擇確保如果查詢在遠端伺服器上執行多次表掃描，它將為所有掃描獲得快照一致的結果。其結果是，單個事務內的連續查詢將從遠端伺服器看到相同的資料，即使遠端伺服器由於其他活動正在進行併發更新。如果本地事務使用 SERIALIZABLE 或 REPEATABLE READ 隔離級別，則可以預期這種行為，但對於 READ COMMITTED 本地事務來說，這可能會令人驚訝。未來的 PostgreSQL 版本可能會修改這些規則。

請注意，postgres_fdw 目前不支援為兩階段提交準備遠端事務。

postgres_fdw 嘗試最佳化遠端查詢，以減少從外部伺服器傳輸的資料量。這是透過將查詢 WHERE 子句傳送到遠端伺服器執行，以及不檢索當前查詢不需要的表列來實現的。為減少查詢誤執行的風險，除非 WHERE 子句僅使用內建的或屬於 extensions 選項中列出的擴充套件的資料型別、運算子和函式，否則不會將其傳送到遠端伺服器。此類子句中的運算子和函式也必須是 IMMUTABLE。對於 UPDATE 或 DELETE 查詢，如果不存在不能傳送到遠端伺服器的查詢 WHERE 子句、沒有本地連線、目標表上沒有行級本地 BEFORE 或 AFTER 觸發器或儲存的生成列，以及沒有父檢視的 CHECK OPTION 約束，postgres_fdw 會嘗試透過將整個查詢傳送到遠端伺服器來最佳化查詢執行。在 UPDATE 中，賦值給目標列的表示式必須僅使用內建資料型別、IMMUTABLE 運算子或 IMMUTABLE 函式，以降低查詢誤執行的風險。

當 postgres_fdw 遇到同一外部伺服器上的外部表之間的連線時，它會將整個連線傳送到外部伺服器，除非出於某種原因它認為單獨獲取每個表的行效率更高，或者除非涉及的表引用受不同的使用者對映管轄。在傳送 JOIN 子句時，它會採取與上述 WHERE 子句相同的預防措施。

實際傳送到遠端伺服器執行的查詢可以使用 EXPLAIN VERBOSE 來檢視。

在 postgres_fdw 開啟的遠端會話中，search_path 引數被設定為僅 pg_catalog，因此只有內建物件在沒有模式限定的情況下可見。這對於透過遠端表上的觸發器或規則在遠端伺服器上執行的函式來說不是問題。例如，如果遠端表實際上是一個檢視，那麼在該檢視中使用的任何函式都將在受限制的搜尋路徑下執行。建議對這些函式中的所有名稱進行模式限定，或者將 SET search_path 選項（參見 CREATE FUNCTION）附加到這些函式上，以建立其預期的搜尋路徑環境。

postgres_fdw 同樣會為各種引數建立遠端會話設定

這些問題不像 search_path 那麼容易出現問題，但如果需要，可以透過函式 SET 選項來處理。

強烈不建議透過更改這些引數的會話級設定來覆蓋此行為；這很可能會導致 postgres_fdw 出現故障。

postgres_fdw 可與早至 PostgreSQL 8.3 的遠端伺服器一起使用。只讀功能可追溯到 8.1。

然而，一個限制是 postgres_fdw 通常假定不可變的內建函式和運算子可以安全地傳送到遠端伺服器執行，如果它們出現在外部表的 WHERE 子句中。因此，自遠端伺服器釋出以來新增的內建函式可能會被髮送給它執行，從而導致 “函式不存在” 或類似的錯誤。可以透過重寫查詢來解決此類失敗，例如，將外部表引用嵌入到帶有 OFFSET 0 的子 SELECT 中作為最佳化屏障，並將有問題的函式或運算子放在子 SELECT 之外。

另一個限制是，當在外部表上執行帶有 ON CONFLICT DO NOTHING 子句的 INSERT 語句時，遠端伺服器必須執行 PostgreSQL 9.5 或更高版本，因為早期版本不支援此功能。

postgres_fdw 可以在 Extension 等待事件型別下報告以下等待事件

以下是使用 postgres_fdw 建立外部表的示例。首先安裝擴充套件

CREATE EXTENSION postgres_fdw;

然後使用 CREATE SERVER 建立外部伺服器。在本例中，我們希望連線到主機 192.83.123.89 上監聽埠 5432 的 PostgreSQL 伺服器。連線到的資料庫在遠端伺服器上名為 foreign_db。

CREATE SERVER foreign_server
        FOREIGN DATA WRAPPER postgres_fdw
        OPTIONS (host '192.83.123.89', port '5432', dbname 'foreign_db');

還需要使用 CREATE USER MAPPING 定義使用者對映，以識別將在遠端伺服器上使用的角色。

CREATE USER MAPPING FOR local_user
        SERVER foreign_server
        OPTIONS (user 'foreign_user', password 'password');

現在可以使用 CREATE FOREIGN TABLE 建立外部表。在本例中，我們希望訪問遠端伺服器上名為 some_schema.some_table 的表。其本地名稱將是 foreign_table。

CREATE FOREIGN TABLE foreign_table (
        id integer NOT NULL,
        data text
)
        SERVER foreign_server
        OPTIONS (schema_name 'some_schema', table_name 'some_table');

宣告在 CREATE FOREIGN TABLE 中的列的資料型別和其他屬性必須與實際遠端表匹配，這一點至關重要。列名也必須匹配，除非您將 column_name 選項附加到各個列，以顯示它們在遠端伺服器上的命名方式。在許多情況下，使用 IMPORT FOREIGN SCHEMA 比手動構建外部表定義更可取。

Shigeru Hanada <shigeru.hanada@gmail.com>