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也会为各种参数建立远程会话设置

这些不太可能出现问题，但如果需要，可以使用函数SET选项来处理。

建议不要通过更改这些参数的会话级设置来覆盖此行为；这可能会导致postgres_fdw发生故障。

postgres_fdw 可用于可以追溯到 PostgreSQL 8.3 的远程服务器。可追溯到 8.1 的只读功能可用。但是，有一个限制，即 postgres_fdw 通常假设可将不可变内置函数和运算符安全地发送到远程服务器以供执行，如果它们出现在外表的 WHERE 子句中。因此，远程服务器发布之后新增的内置函数可能会被发送到远程服务器进行执行，从而导致 “函数不存在” 或类似错误。通过重写查询可以解决这种类型的故障，例如通过在外表引用中嵌入子-SELECT，并以 OFFSET 0 作为优化标记，并将有问题的函数或运算符置于子-SELECT 之外。

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 <[email protected]>