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>