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。但是，一个限制是 postgres_fdw 通常假设不可变的内置函数和操作符可以安全地发送到远程服务器执行，如果它们出现在外部表的 WHERE 子句中。因此，在远程服务器发布后添加的内置函数可能会被发送到它执行，从而导致“函数不存在”或类似的错误。可以通过重写查询来解决此类故障，例如通过将外部表引用嵌入到带有 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 <[email protected]>