postgres_fdw：访问外部 PostgreSQL 服务器中的数据

使用 postgres_fdw 外部数据封装器的外部服务器，可使用 libpq 连接字符串接受的相同选项，详见 Section 32.1.2；但下列选项不允许使用或会被特殊处理：

只有超级用户可以创建或修改包含 sslcert 或 sslkey 设置的用户映射。

非超级用户可以通过密码验证或 GSSAPI 委派凭据连接外部服务器。因此，对于需要密码验证的非超级用户映射，应指定 password 选项。

超级用户可以逐个用户映射覆盖此检查，将用户映射选项设为 password_required 'false'，例如：

ALTER USER MAPPING FOR some_non_superuser SERVER loopback_nopw
OPTIONS (ADD password_required 'false');

为防止普通用户利用 postgres 服务器所运行的 Unix 用户的认证权限，提升为超级用户，只有超级用户可以在用户映射上设置此选项。

必须谨慎确保这不会让映射用户以超级用户身份连接映射数据库，相关问题见 CVE-2007-3278 和 CVE-2007-6601。不要对 public 角色设置 password_required=false。映射用户可能使用 postgres 服务器所运行系统用户的 Unix 主目录中的任何客户端证书、.pgpass、.pg_service.conf 等；主目录的查找方式见 Section 32.16。它也可能利用 peer 或 ident 等认证方式授予的信任关系。

这些选项控制发送给远程 PostgreSQL 服务器的 SQL 语句所使用的名称。当创建外部表时使用的名称与底层远程表不同，就需要这些选项。

postgres_fdw 通过在远程服务器执行查询获取数据，因此理想情况下，扫描外部表的估算成本应当等于远程服务器上的执行成本加上一些通信开销。最可靠的估算方式是向远程服务器询问，再加上额外开销；但对简单查询而言，为了估算成本额外执行一次远程查询可能不值得。因此，postgres_fdw 提供以下选项控制成本估算：

use_remote_estimate 为 true 时，postgres_fdw 从远程服务器获取行数和成本估算，再将 fdw_startup_cost 和 fdw_tuple_cost 加入成本估算。use_remote_estimate 为 false 时，postgres_fdw 在本地估算行数和成本，再加上 fdw_startup_cost 和 fdw_tuple_cost。除非本地保存了远程表统计信息的副本，否则本地估算很可能不准确。对外部表运行 ANALYZE 可更新本地统计信息：它扫描远程表，然后像处理本地表一样计算并保存统计信息。维护本地统计信息有助于减少远程表每次查询的规划开销；但如果远程表频繁更新，本地统计信息很快会过时。

下面的选项控制这种 ANALYZE 操作的行为：

默认只考虑将使用内置运算符和函数的 WHERE 子句发送到远程服务器执行。涉及非内置函数的子句，在取回行后在本地检查。如果远程端也有这些函数，并且能可靠地产生与本地相同的结果，把这些 WHERE 子句发送到远程执行可以改善性能。下面的选项控制此行为：

postgres_fdw 支持异步执行，通过并发而非串行运行 Append 节点的多个部分来改善性能。以下选项控制此行为：

如事务管理章节所述，postgres_fdw 通过创建对应远程事务管理事务，通过创建对应远程子事务管理子事务。当前本地事务涉及多个远程事务时，默认由 postgres_fdw 在本地事务提交或中止时串行提交或中止各远程事务。当前本地子事务涉及多个远程子事务时，默认由 postgres_fdw 在本地子事务提交或中止时串行处理。以下选项可改善性能：

若本地事务涉及多个启用了这些选项的外部服务器，本地事务提交或中止时，这些服务器上的多个远程事务会跨服务器并行提交或中止。

启用这些选项后，若某外部服务器拥有许多远程事务，本地事务提交或中止时，该服务器可能受到负面性能影响。

默认假定使用 postgres_fdw 的所有外部表都可更新。可用下面的选项覆盖：

默认假定使用 postgres_fdw 的所有外部表都可截断。可用下面的选项覆盖：

postgres_fdw 能够通过 IMPORT FOREIGN SCHEMA 导入外部表定义。该命令在本地创建与远程服务器中的表或视图匹配的外部表定义。如果待导入的远程表包含用户自定义类型的列，本地服务器必须具有同名的兼容类型。

可以在 IMPORT FOREIGN SCHEMA 命令中指定以下选项，自定义导入行为：

除了 NOT NULL，不会从远程表导入其他约束。虽然 PostgreSQL 支持外部表检查约束，但不会自动导入，因为约束表达式在本地和远程服务器可能求值不同。检查约束的行为不一致可能造成难以发现的查询优化错误。因此，如需导入检查约束，必须手动完成，并仔细验证每个约束的语义。外部表检查约束处理的更多细节见 CREATE FOREIGN TABLE。

作为其他表分区的表或外部表，只有在 LIMIT TO 子句中明确指定时才会导入，否则会自动从 IMPORT FOREIGN SCHEMA 中排除。由于可以通过分区层级根节点的分区表访问全部数据，只导入分区表，就应能访问所有数据而不创建多余对象。

默认情况下，postgres_fdw 与外部服务器建立的所有连接都会在本地会话中保持打开，以供复用。

postgres_fdw_get_connections( IN check_conn boolean DEFAULT false, OUT server_name text, OUT user_name text, OUT valid boolean, OUT used_in_xact boolean, OUT closed boolean, OUT remote_backend_pid int4) returns setof record

此函数返回 postgres_fdw 从本地会话到外部服务器建立的所有打开连接的信息。如果没有打开的连接，则不返回记录。

若 check_conn 设为 true，函数会检查每条连接状态，并在 closed 列显示结果。目前只有支持 poll 系统调用的非标准 POLLRDHUP 扩展的系统提供此功能，包括 Linux。它可检查事务内使用的连接是否仍然打开。如果任何连接已关闭，事务就无法成功提交，因此检测到关闭连接时应尽早回滚，不要继续到事务结束。若函数报告某连接的 used_in_xact 和 closed 都为 true，用户可以立即回滚事务。

函数用法示例：

postgres=# SELECT * FROM postgres_fdw_get_connections(true);
 server_name | user_name | valid | used_in_xact | closed | remote_backend_pid
-------------+-----------+-------+--------------+-----------------------------
 loopback1   | postgres  | t     | t            | f      |            1353340
 loopback2   | public    | t     | t            | f      |            1353120
 loopback3   |           | f     | t            | f      |            1353156

输出列见 表 F.28。

表 F.28. postgres_fdw_get_connections 的输出列

列	类型	描述
server_name	text	该连接的外部服务器名称。如果服务器已被删除，但连接仍然打开，即被标记为无效，则为 NULL。
user_name	text	该连接中映射到外部服务器的本地用户名称；使用公共映射时为 public。如果用户映射已被删除，但连接仍然打开，即被标记为无效，则为 NULL。
valid	boolean	连接无效时为 false，即当前事务正在使用该连接，但它的外部服务器或用户映射已经被修改或删除。无效连接会在事务结束时关闭。其他情况返回 true。
used_in_xact	boolean	当前事务正在使用该连接时为 true。
closed	boolean	连接关闭时为 true，否则为 false。如果 check_conn 设为 false，或者此平台不能检查连接状态，则返回 NULL。
remote_backend_pid	int4	在外部服务器上处理该连接的远程后端进程 ID。如果远程后端终止且连接关闭（closed 为 true），这里仍显示已经终止的后端进程 ID。

postgres_fdw_disconnect(server_name text) returns boolean

此函数丢弃 postgres_fdw 从本地会话到指定名称的外部服务器建立的打开连接。注意，可能通过不同用户映射对同一服务器建立多条连接。若连接正在被当前本地事务使用，则不关闭，并报告警告。至少关闭一条连接时返回 true，否则返回 false。找不到指定名称的外部服务器则报错。示例：

postgres=# SELECT postgres_fdw_disconnect('loopback1');
 postgres_fdw_disconnect
-------------------------
 t

postgres_fdw_disconnect_all() returns boolean

此函数丢弃 postgres_fdw 从本地会话到外部服务器建立的所有打开连接。若连接正在被当前本地事务使用，则不关闭，并报告警告。至少关闭一条连接时返回 true，否则返回 false。示例：

postgres=# SELECT postgres_fdw_disconnect_all();
 postgres_fdw_disconnect_all
-----------------------------
 t

• TimeZone 设为 UTC。

• DateStyle 设为 ISO。

• IntervalStyle 设为 postgres。

• 远程服务器9.0及之后版本的 extra_float_digits 设为 3；更早版本设为 2。

PostgresFdwCleanupResult

等待远程服务器上的事务中止。

PostgresFdwConnect

等待与远程服务器建立连接。

PostgresFdwGetResult

等待从远程服务器接收查询结果。

postgres_fdw.application_name (string) #

指定 postgres_fdw 建立外部服务器连接时使用的 application_name 配置参数值。它覆盖服务器对象的 application_name 选项。修改此参数不会影响已经建立的连接，直到连接重新建立。

postgres_fdw.application_name 可以是任意长度的字符串，甚至包含非 ASCII 字符。但作为 application_name 传给外部服务器时，会被截短为少于 NAMEDATALEN 个字符。除可打印 ASCII 字符外的内容，会替换成 C 风格十六进制转义。详见 application_name。

% 字符开始一个“转义序列”，按下表替换为状态信息。未识别的转义被忽略，其他字符直接复制到应用名称。注意，不允许在 % 之后、选项之前指定正负号或数字字面量来进行对齐和填充。

转义	效果
%a	本地服务器上的应用名称
%c	本地服务器上的会话 ID，详见 log_line_prefix。
%C	本地服务器上的集群名称，详见 cluster_name。
%u	本地服务器上的用户名
%d	本地服务器上的数据库名
%p	本地服务器上的后端进程 ID
%%	字面量 %

例如，用户 local_user 从数据库 local_db 以 foreign_user 用户身份连接 foreign_db 时，设置 'db=%d, user=%u' 会被替换为 'db=local_db, user=local_user'。