postgres_fdw 在首次执行使用与某个外部服务器关联的外部表的查询时，会建立到该外部服务器的连接。默认情况下，该连接会在同一会话中保留并供后续查询重用。这一行为可通过外部服务器的 keep_connections 选项控制。如果使用多个用户标识（用户映射）访问该外部服务器，则会为每个用户映射建立一个连接。

当更改外部服务器或用户映射的定义，或将其删除时，相关连接会被关闭。但请注意，如果任何连接在当前本地事务中正在使用，则会保留到事务结束。关闭的连接会在后续使用外部表的查询需要它们时重新建立。

一旦与外部服务器建立连接，默认情况下它会一直保留到本地会话或对应的远程会话退出。要显式断开连接，可以禁用外部服务器的 keep_connections 选项，或使用 postgres_fdw_disconnect 和 postgres_fdw_disconnect_all 函数。例如，这些函数可用于关闭不再需要的连接，从而释放外部服务器上的连接资源。

postgres_fdw 使用与第 F.40.1.1 节中描述相同的选项来支持订阅连接。

例如，假设远程服务器 foreign-host 上有一个发布 testpub：

CREATE SERVER subscription_server FOREIGN DATA WRAPPER postgres_fdw OPTIONS (host 'foreign-host', dbname 'foreign_db');
CREATE USER MAPPING FOR local_user SERVER subscription_server OPTIONS (user 'foreign_user', password 'password');
CREATE SUBSCRIPTION my_subscription SERVER subscription_server PUBLICATION testpub;

要创建订阅，用户必须是 pg_create_subscription 角色的成员，并且对该服务器具有 USAGE 权限。

在引用某个外部服务器上任意远程表的查询期间，如果当前本地事务尚未在该远程服务器上打开对应的事务，postgres_fdw 就会在该远程服务器上打开一个事务。本地事务提交或中止时，远程事务也会提交或中止。保存点也会通过创建对应的远程保存点进行类似管理。

当本地事务的隔离级别为 SERIALIZABLE 时，远程事务使用 SERIALIZABLE；否则使用 REPEATABLE READ 隔离级别。这一选择确保如果一个查询在远程服务器上执行多次表扫描，所有扫描都能获得快照一致的结果。其结果是，同一事务中的后续查询会看到来自远程服务器的相同数据，即使远程服务器由于其他活动正在发生并发更新。对于使用 SERIALIZABLE 或 REPEATABLE READ 隔离级别的本地事务，这种行为本来就符合预期；但对于 READ COMMITTED 本地事务，则可能令人意外。未来的 PostgreSQL 版本可能会修改这些规则。

远程事务会以与本地事务相同的读写模式打开：如果本地事务是 READ ONLY，则远程事务以 READ ONLY 模式打开；否则它以 READ WRITE 模式打开。（这一规则也适用于远程和本地子事务。）请注意，这并不会阻止远程服务器上执行的登录触发器写入数据。

远程事务也会以与本地事务相同的可延迟模式打开：如果本地事务是 DEFERRABLE，则远程事务以 DEFERRABLE 模式打开；否则它以 NOT DEFERRABLE 模式打开。

请注意，postgres_fdw 当前不支持为两阶段提交预备远程事务。

postgres_fdw 会尽力优化远程查询，以减少从外部服务器传输的数据量。这是通过将查询的 WHERE 子句发送到远程服务器执行，以及不获取当前查询不需要的表列来实现的。为降低查询被错误执行的风险，只有当 WHERE 子句使用的所有数据类型、操作符和函数都是内置的，或属于外部服务器 extensions 选项列出的扩展时，才会将该子句发送到远程服务器。这类子句中的操作符和函数还必须是 IMMUTABLE。对于 UPDATE 或 DELETE 查询，postgres_fdw 会在查询中不存在无法发送到远程服务器的 WHERE 子句、没有本地连接操作、目标表上没有行级本地 BEFORE 或 AFTER 触发器或存储生成列，也没有来自父视图的 CHECK OPTION 约束时，尝试将整个查询发送到远程服务器以优化执行。在 UPDATE 中，为了降低查询被错误执行的风险，赋给目标列的表达式也必须只使用内置数据类型、IMMUTABLE 操作符或 IMMUTABLE 函数。

当 postgres_fdw 遇到同一外部服务器上的外部表之间的连接时，除非由于某种原因它认为分别从各表取回行会更高效，或者相关表引用受不同用户映射约束，否则会将整个连接发送到远程服务器。在发送 JOIN 子句时，它也会采取与前述 WHERE 子句相同的预防措施。

外部表与作为 FROM 列表项出现的返回集合的函数之间的 INNER JOIN 也可以被下推：函数调用被纳入远程查询，从而只取回与函数输出匹配的行。只有当函数是 IMMUTABLE（从而保证在远程服务器上求值与在本地求值产生相同结果）、其参数及针对它的所有限制子句都可以被发送到远端，且不存在以下任何不符合条件的情况时，才会尝试这样做：连接类型不是 INNER；函数使用了 WITH ORDINALITY；函数返回 record 类型却未附带列定义列表；或者函数横向引用了同一查询层级的另一个关系。允许函数参数来自外层查询层级，这种参数会作为查询参数传给远程服务器。

可以使用 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。

不过有一个限制是，postgres_fdw 通常假定：如果外部表的 WHERE 子句中出现不可变的内置函数和操作符，那么把它们发送到远程服务器执行是安全的。因此，某个在远程服务器所属发行版本之后才加入的内置函数，可能仍会被发送到该远程服务器执行，从而导致“function does not exist”或类似错误。可以通过重写查询绕过这类失败，例如把外部表引用放入一个带 OFFSET 0 的子 SELECT 中，作为优化栅栏，并将有问题的函数或操作符放到子 SELECT 之外。

另一个限制是，在外部表上执行 INSERT 语句并带有 ON CONFLICT DO NOTHING 子句时，远程服务器必须运行 PostgreSQL 9.5 或更高版本，因为更早版本不支持此特性。

postgres_fdw 可以在等待事件类型 Extension 下报告以下等待事件：

下面是使用 postgres_fdw 创建外部表的一个示例。首先安装扩展：

CREATE EXTENSION postgres_fdw;

然后使用 CREATE SERVER 创建外部服务器。在本示例中，希望连接到一台 PostgreSQL 服务器，它运行在主机 192.83.123.89 上并监听 5432 端口。要连接的数据库在远程服务器上名为 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>