Postgres FDW 全面详解
一、什么是 postgres_fdw（背景）
postgres_fdw 是 PostgreSQL 官方提供的 foreign-data wrapper
(FDW) ，用于在一个 PostgreSQL 实例中访问另一个 PostgreSQL
实例的表，实现跨库访问、数据联邦。
二、使用场景
2.1 跨库查询/数据联邦
将多个 PostgreSQL 实例的数据统一查询（例如把 OLTP 数据库与历史库联合查询用于报表）。
2.2 数据迁移 / 升级
在迁移过程中，临时将旧库映射为外部表，逐步迁移与校验。
2.3 拆分/分片（逻辑层）
将不同业务数据放在不同实例，通过 FDW 在一个查询中联合多个分片。
2.4 只读报表 / BI
BI/报表库访问生产库的指定表，无需 ETL 即可读取最新数据（注意性能与隔离）。
2.5 将外部表作为微服务接口
通过 SQL 直接访问其他数据库提供的数据服务。
三、实现步骤流程
3.1 启用扩展
sql
CREATE EXTENSION postgres_fdw;3.2 创建远端服务器连接
sql
CREATE SERVER remote_srv
FOREIGN DATA WRAPPER postgres_fdw
OPTIONS (host '127.0.0.1', port '5432', dbname 'postgres');-
创建一个外部服务器对象 remote_srv，告诉本地 PostgreSQL 如何连接到远端 PostgreSQL（IP、端口、目标数据库名）。
-
FOREIGN DATA WRAPPER postgres_fdw 指定使用哪个 FDW 实现（这里是官方的 postgres_fdw）。
-
OPTIONS 中可添加更多选项（例如 SSL 相关的选项，或特定 FDW 支持的参数）。
3.3 创建本地用户到远端数据库的账号映射
sql
CREATE USER MAPPING FOR postgres
SERVER remote_srv
OPTIONS (user 'postgres', password 'postgres');-
为本地数据库中的某个角色（这里是本地角色 postgres）创建到 remote_srv 的用户映射。即执行跨库操作时使用的远端用户名/密码。
-
也可以为多个本地角色分别创建不同的映射。
-
安全提示：在生产中不要把明文密码写入 SQL；可使用 .pgpass、外部凭据管理或连接限制与最小权限原则。
3.4 导入远端 schema 中指定表为本地外部表
sql
IMPORT FOREIGN SCHEMA public
LIMIT TO (config_info)
FROM SERVER remote_srv
INTO public;-
从远端服务器
remote_srv的public schema导入外部表定义到当前数据库的 public schema。 -
LIMIT TO (config_info)表示只导入远端的config_info表（可用 EXCEPT 排除或不指定以导入全部）。 -
导入的是表结构（列名、类型等），不会复制数据；查询外部表时数据通过网络从远端读取。
-
导入后在本地你会看到
config_info作为一个FOREIGN TABLE，可以像普通表一样 SELECT，如果远端用户有权限并且 FDW 支持，也可以INSERT/UPDATE/DELETE。
四、结论
postgres_fdw 是获取跨 PostgreSQL
集群数据的官方最佳方案，适用于分库查询、数据迁移、报表系统。