大数据智能体工作台 DataBuddy PostgreSQL 数据源

二、支持的版本

三、读取能力

完整数据源能力对照参见 支持的数据源与读取能力。

五、实时同步限制

六、离线同步限制

七、支持的字段类型

完整字段类型请参见 PostgreSQL 产品文档。

八、字段类型映射（离线同步）

同步时源端字段类型会转换为 DataBuddy 内部类型（同步链路中的中间类型）。配置任务前请重点核对「备注」列标注的类型，避免精度丢失或语义变化。

九、字段类型映射（实时同步）

实时同步（整库多表）由 CDC 连接器解析源端类型并写入 TCLake。下表为自动建表时目标表实际使用的字段类型 ，配置任务前请重点核对「备注」列标注的类型。

注意：说明：

十一、DML

十二、DDL

PostgreSQL 逻辑复制对 DDL 变更的支持有限，Schema 变更后可能需要重新配置同步任务与发布。

十四、1. 配置账号权限

离线同步 ：

CREATE USER wedata_user WITH PASSWORD 'your_password';GRANT CONNECT ON DATABASE your_database TO wedata_user;GRANT USAGE ON SCHEMA public TO wedata_user;GRANT SELECT ON ALL TABLES IN SCHEMA public TO wedata_user;

实时同步 ：

CREATE USER wedata_cdc_user WITH REPLICATION PASSWORD 'your_password';GRANT CONNECT ON DATABASE your_database TO wedata_cdc_user;GRANT USAGE ON SCHEMA public TO wedata_cdc_user;GRANT SELECT ON ALL TABLES IN SCHEMA public TO wedata_cdc_user;

十五、2. 配置 WAL 级别（仅实时同步）

SHOW wal_level;

腾讯云 PostgreSQL 在控制台「参数设置」中将 wal_level 设置为 logical。自建 PostgreSQL 修改 postgresql.conf：

wal_level = logicalmax_replication_slots = 10max_wal_senders = 10

修改后需要重启数据库才能生效。

十六、3. 配置 pg_hba.conf（仅实时同步）

# TYPE DATABASE USER ADDRESS METHODhost replication wedata_cdc_user 10.0.0.0/8 md5

十七、4. 创建发布（仅实时同步）

CREATE PUBLICATION wedata_pub FOR TABLE table1, table2;– 或：CREATE PUBLICATION wedata_pub FOR ALL TABLES;

十八、5. 设置 REPLICA IDENTITY（无主键表）

ALTER TABLE your_table REPLICA IDENTITY FULL;

20、操作步骤

1. 登录 DataBuddy 控制台。

2. 在顶部切换到目标地域和 Workspace。

3. 进入 数据集成 > 数据源管理 （或 平台管理 > 数据源管理 ）。

4. 点击 添加数据源 ，选择 PostgreSQL 。

5. 填写连接配置与认证信息，详见 参数说明。

6. 点击 连通性测试 （参见 数据源连通性测试）。

7. 测试通过后点击 保存 或 保存 & 创建任务 。

21、参数说明

23、实时整库

24、离线单表

详细任务配置参见 表到表同步 与 实时整库多表任务配置。

25、最佳实践

·账号权限最小化 ：使用专用账号，仅授必要权限。

·WAL 日志保留 ：ALTER SYSTEM SET wal_keep_size = '1GB';

·切割键选择 ：主键或索引列。

·网络打通 ：优先使用内网连接。

27、Q：实时同步报错 wal_level 不支持？

A：未将 wal_level 设置为 logical。

ALTER SYSTEM SET wal_level = 'logical';– 修改后需重启数据库

28、Q：报错无法创建复制槽？

A：max_replication_slots 太小：

ALTER SYSTEM SET max_replication_slots = 20;

29、Q：无主键表 UPDATE / DELETE 无法正确同步？

A：未设置 REPLICA IDENTITY：

ALTER TABLE your_table REPLICA IDENTITY FULL;

30、Q：连接被拒绝？

A：pg_hba.conf 未允许 DataBuddy 网段连接。在文件中添加：

host all wedata_user 10.0.0.0/8 md5host replication wedata_cdc_user 10.0.0.0/8 md5

31、Q：包含特殊字符的表名无法同步？

A：不支持表名、字段名以数字开头或包含大小写字母、中划线

32、相关文档

·添加数据源连接

·数据源连通性测试

·支持的数据源与读取能力

·实时整库多表任务配置