Foreign Data Wrapper如何配置

Foreign Data Wrapper（FDW，外部数据包装器） 是 PostgreSQL 用来访问外部数据源（如 MySQL、Oracle、CSV、Redis、其他 PostgreSQL 等）的机制。下面以 PostgreSQL 为例，系统说明如何配置 FDW。

一、FDW 基本组成

配置 FDW 通常需要以下几步：

1. 安装 FDW 扩展
2. 创建外部服务器（Server）
3. 创建用户映射（User Mapping）
4. 创建外部表（Foreign Table）
5. 查询外部表

二、以 postgres_fdw 为例（PostgreSQL → PostgreSQL）

1. 安装扩展

CREATE EXTENSION IF NOT EXISTS postgres_fdw;

2. 创建外部服务器

CREATE SERVER remote_pg
FOREIGN DATA WRAPPER postgres_fdw
OPTIONS (
  host '192.168.1.100',
  port '5432',
  dbname 'remote_db'
);

3. 创建用户映射

CREATE USER MAPPING FOR current_user
SERVER remote_pg
OPTIONS (
  user 'remote_user',
  password 'remote_password'
);

4. 创建外部表

CREATE FOREIGN TABLE foreign_users (
  id int,
  name text,
  created_at timestamp
)
SERVER remote_pg
OPTIONS (
  schema_name 'public',
  table_name 'users'
);

5. 查询外部表

SELECT * FROM foreign_users;

三、常见 FDW 类型

四、以 file_fdw 为例（读取 CSV）

CREATE EXTENSION file_fdw;

CREATE SERVER csv_server
FOREIGN DATA WRAPPER file_fdw;

CREATE FOREIGN TABLE emp_csv (
  id int,
  name text,
  dept text
)
SERVER csv_server
OPTIONS (
  filename '/data/emp.csv',
  format 'csv',
  header 'true'
);

五、权限与注意事项

• 用户需有 USAGE 权限
• 密码建议通过 .pgpass 或安全方式管理
• 外部表不支持索引（部分 FDW 例外）
• 性能受网络和数据源影响

六、常见问题排查

\des        -- 查看外部服务器
\deu        -- 查看用户映射
\det        -- 查看外部表

错误示例：

• could not connect → 网络 / 防火墙
• permission denied → 用户映射或权限问题

如果你有具体的数据源（MySQL / Oracle / CSV / 其他 PG）或使用场景，我可以给你一份针对性配置示例。