pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。
postgres_fdw 模块提供外部数据包装器 postgres_fdw，可用于访问存储在外部 PostgreSQL 服务器中的数据。
本模块提供的功能与较旧的 dblink 模块在很大程度上重叠。 但 postgres_fdw 为访问远程表提供了更透明且符合标准的语法， 并且在许多情况下性能更好。
要准备通过 postgres_fdw 进行远程访问：
安装 postgres_fdw 扩展，可使用 CREATE EXTENSION。
使用 CREATE SERVER 创建外部服务器对象， 用来表示每个要连接的远程数据库。将除 user 和 password 之外的连接信息指定为服务器对象的选项。
对于每个需要获准访问各个外部服务器的数据库用户，使用 CREATE USER MAPPING 创建用户映射。将要使用的 远程用户名和密码指定为用户映射的 user 和 password 选项。
对于每个要访问的远程表，使用 CREATE FOREIGN TABLE 创建外部表。 外部表的列必须与被引用的远程表匹配。不过，如果在外部表对象的选项中 指定正确的远程名称，也可以使用与远程表不同的表名和/或列名。
现在，只需对外部表执行 SELECT，即可访问其底层远程表中 存储的数据。也可以使用 INSERT、UPDATE 或 DELETE 修改远程表。 （当然，在用户映射中指定的远程用户必须拥有执行这些操作的权限。）
通常建议将外部表的列声明为与被引用远程表的对应列具有完全相同的数据类型， 并在适用时具有相同的排序规则。尽管 postgres_fdw 目前在按需执行数据类型转换方面相当宽容，但当类型或排序规则不匹配时， 仍可能出现令人意外的语义异常，因为远程服务器对 WHERE 子句的 解释与本地服务器略有不同。
请注意，外部表的声明可以比其底层远程表少一些列，或者使用不同的列顺序。 与远程表列的匹配是按名称而不是按位置进行的。
使用postgres_fdw外部数据包装器的外部服务器，可以使用与libpq连接字符串所接受的相同选项，详见第 31.1.2 节，但以下选项不被允许：
user 和 password（应改为在用户映射中指定）
client_encoding（会根据本地服务器编码自动设置）
fallback_application_name（始终设置为 postgres_fdw）
只有超级用户才能不使用密码认证连接到外部服务器，因此应始终为属于非超级用户的用户映射指定 password 选项。
这些选项可用于控制发送到远程 PostgreSQL 服务器的 SQL 语句中所使用的名称。当创建外部表时所用的名称与其底层 远程表的名称不同时，就需要这些选项。
schema_name该选项可为外部表指定，用于给出在远程服务器上为该外部表使用的模式名。 如果省略，则使用外部表自身所在模式的名称。
table_name该选项可为外部表指定，用于给出在远程服务器上为该外部表使用的表名。 如果省略，则使用外部表自身的名称。
column_name该选项可为外部表的某个列指定，用于给出在远程服务器上为该列使用的列名。 如果省略，则使用该列自身的名称。
postgres_fdw 通过在远程服务器上执行查询来获取远程数据， 因此，理想情况下，扫描外部表的估计代价应当等于在远程服务器上完成该操作的 代价，再加上一些通信开销。获得这种估算最可靠的方法，是向远程服务器询问， 再把开销加上去；但对于简单查询，为了取得代价估算而额外发送一次远程查询， 可能并不划算。因此 postgres_fdw 提供以下选项来控制 代价估算的方式：
use_remote_estimate该选项可为外部表或外部服务器指定，用于控制 postgres_fdw 是否发出远程 EXPLAIN 命令来获取代价估算。外部表上的设置会覆盖其所属服务器的设置，但只对 该表生效。默认值为 false。
fdw_startup_cost该选项可为外部服务器指定，是一个数值，会被加到该服务器上任何 外部表扫描的估计启动代价中。它表示建立连接、在远程端解析并规划查询等 额外开销。默认值为 100。
fdw_tuple_cost该选项可为外部服务器指定，是一个数值，用作该服务器上外部表扫描的 每个元组的额外代价。它表示服务器之间数据传输的额外开销。可以增大或 减小该数值，以反映到远程服务器更高或更低的网络延迟。默认值为 0.01。
当 use_remote_estimate 为真时， postgres_fdw 从远程服务器获取行数和代价估算，然后 将 fdw_startup_cost 和 fdw_tuple_cost 加到代价估算中。当 use_remote_estimate 为假时， postgres_fdw 在本地执行行数和代价估算，然后再将 fdw_startup_cost 和 fdw_tuple_cost 加到代价估算中。除非有远程表统计信息的本地副本可用，否则这种本地估算 不太可能非常准确。更新本地统计信息的方法，是在外部表上运行 ANALYZE；这样会扫描远程表，然后像对待本地表一样 计算并存储统计信息。保留本地统计信息可以有效减少远程表每次查询的规划开销； 但如果远程表经常更新，本地统计信息很快就会过时。
默认情况下，所有使用 postgres_fdw 的外部表都被 假定为可更新。这一点可以通过以下选项覆盖：
updatable该选项控制 postgres_fdw 是否允许使用 INSERT、UPDATE 和 DELETE 命令修改外部表。它可为外部表或外部服务器 指定。表级选项会覆盖服务器级选项。默认值为 true。
当然，如果远程表实际上不可更新，最终仍会报错。该选项的主要作用是 允许在本地直接抛出错误，而无需查询远程服务器。但请注意， information_schema 视图会根据该选项的设置，将 postgres_fdw 外部表报告为可更新（或不可更新）， 而不会对远程服务器进行任何检查。
postgres_fdw 在首次执行使用与某个外部服务器关联的 外部表的查询时，会建立到该外部服务器的连接。该连接会在同一会话中保留并供后续查询重用。如果使用多个用户标识 （用户映射）访问该外部服务器，则会为每个用户映射建立一个连接。
在引用某个外部服务器上任意远程表的查询期间，如果当前本地事务尚未在该 远程服务器上打开对应的事务，postgres_fdw 就会在 该远程服务器上打开一个事务。本地事务提交或中止时，远程事务也会提交或 中止。保存点也会通过创建对应的远程保存点进行类似管理。
当本地事务的隔离级别为 SERIALIZABLE 时，远程事务使用 SERIALIZABLE；否则使用 REPEATABLE READ 隔离级别。这一选择确保如果一个查询 在远程服务器上执行多次表扫描，所有扫描都能获得快照一致的结果。其结果是， 同一事务中的后续查询会看到来自远程服务器的相同数据，即使远程服务器由于 其他活动正在发生并发更新。对于使用 SERIALIZABLE 或 REPEATABLE READ 隔离级别的本地事务，这种行为本来就 符合预期；但对于 READ COMMITTED 本地事务，则可能令人 意外。未来的 PostgreSQL 版本可能会修改这些 规则。
postgres_fdw 会尽力优化远程查询，以减少从外部 服务器传输的数据量。这是通过将查询的 WHERE 子句发送到 远程服务器执行，以及不获取当前查询不需要的表列来实现的。为降低查询被 错误执行的风险，只有当 WHERE 子句使用内置数据类型、 操作符和函数时，才会将该子句发送到远程服务器。这类子句中的操作符和函数还必须是 IMMUTABLE。
可以使用 EXPLAIN VERBOSE 查看实际发送给远程服务器 执行的查询。
在 postgres_fdw 打开的远程会话中， search_path 参数会被设置为仅包含 pg_catalog，这样无需模式限定就只能看到内置对象。 这对 postgres_fdw 自身生成的查询不是问题，因为它 总是提供这种限定。然而，这可能会对那些通过远程表上的触发器或规则在 远程服务器上执行的函数带来风险。例如，如果远程表实际上是一个视图， 则该视图中使用的任何函数都会在受限的搜索路径下执行。建议在这类函数中 对所有名称都写成带模式限定的形式，或者为这类函数附加 SET search_path 选项（见 CREATE FUNCTION），以建立其预期的搜索路径环境。
postgres_fdw 同样会为参数 TimeZone、DateStyle、 IntervalStyle和extra_float_digits 建立远程会话设置。这些设置通常不像 search_path 那样 容易出问题，但如果有需要，也可以通过函数的 SET 选项处理。
不建议通过修改这些参数的会话级设置来覆盖这种行为； 这很可能导致 postgres_fdw 工作异常。
postgres_fdw 可用于最早追溯到 PostgreSQL 8.3 的远程服务器。只读能力可追溯到 8.1。 不过有一个限制是，postgres_fdw 通常假定： 如果外部表的 WHERE 子句中出现不可变的内置函数和 操作符，那么把它们发送到远程服务器执行是安全的。因此，某个在远程服务器 所属发行版本之后才加入的内置函数，可能仍会被发送到该远程服务器执行， 从而导致“function does not exist”或类似错误。可以通过 重写查询绕过这类失败，例如把外部表引用放入一个带 OFFSET 0 的子 SELECT 中，作为优化 栅栏，并将有问题的函数或操作符放到子 SELECT 之外。
Shigeru Hanada <shigeru.hanada@gmail.com>
译文有误、术语不当或页面显示问题，请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题，请在当前版本的对应页面向上游反馈；上游不再修订已结束维护的版本。