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，因此只有內建物件在沒有綱要限定的情況下可見。對於 postgres_fdw 本身產生的查詢，這不是問題，因為它總是提供這種限定。但是，這對於透過遠端資料表上的觸發程序或規則在遠端伺服器上執行的函式可能會造成危險。例如，如果遠端資料表實際上是一個視窗，則在該視窗中使用的任何函式都將以受限的搜尋路徑執行。建議對這些函式中的所有名稱進行綱要限定，或者將 SET search_path 選項（請參閱 CREATE FUNCTION）附加到這些函式，以建立其預期的搜尋路徑環境。

postgres_fdw 也為各種參數建立遠端連線設定

這些問題發生的可能性不如 search_path 那麼大，但如果需要，可以使用函式 SET 選項來處理。

強烈不建議您透過變更這些參數的連線層級設定來覆寫此行為；這可能會導致 postgres_fdw 發生故障。

postgres_fdw 可與追溯到 PostgreSQL 8.3 的遠端伺服器一起使用。回溯到 8.1，可提供唯讀功能。但是，一個限制是，如果 WHERE 子句中出現了外部資料表，postgres_fdw 通常會假設不可變的內建函式和運算子可以安全地傳送到遠端伺服器執行。因此，自遠端伺服器發佈以來新增的內建函式可能會傳送到遠端伺服器執行，從而導致 “function does not exist” 或類似錯誤。可以透過重寫查詢來解決此類故障，例如，透過將外部資料表參考嵌入到具有 OFFSET 0 的子-SELECT 中作為最佳化圍欄，並將有問題的函式或運算子放置在子-SELECT 之外。

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>