概述
GaussDB 是华为云推出的企业级分布式关系型数据库，基于 openGauss 内核，兼容 PostgreSQL 协议，具备高可用、高性能与安全能力。DataBuddy 数据接入支持将 GaussDB 作为来源端，覆盖离线同步与直连分析场景。本文介绍其连接配置、能力支持范围、前提条件与常见问题。
支持的版本
类型 | 支持版本 |
GaussDB | 2.x / 3.x |
读取能力
能力 | 支持情况 | 说明 |
离线同步（读 / 写） | ✓ / - | 支持作为离线同步任务的源端读取数据；DataBuddy 数据源仅支持接入读取，不支持写入 |
直连分析（读 / 写） | ✓ / - | 支持通过直连分析直接查询该数据源；不支持写入 |
使用限制
限制项 | 说明 |
存储过程 | 不支持读取 |
物化视图 | 不支持读取 |
空间类型 | 支持有限，建议转换为字符串 |
支持的字段类型
GaussDB 兼容 PostgreSQL 字段类型，以下是 DataBuddy 的离线读支持情况。
字段类型 | 离线读 |
SMALLINT / INTEGER / BIGINT / BIGSERIAL | ✅ |
REAL / DOUBLE PRECISION / NUMERIC / DECIMAL / MONEY | ✅ |
CHAR / VARCHAR / TEXT | ✅ |
BYTEA | ✅ |
DATE / TIME / TIMESTAMP / TIMESTAMPTZ / INTERVAL | ✅ |
BOOLEAN | ✅ |
JSON / JSONB | ✅ |
UUID | ✅ |
ARRAY | ✅ |
GEOMETRY 等空间类型 | ❌ |
前提条件
配置账号权限
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;
建议为同步任务创建专用账号，仅授
CONNECT、USAGE、SELECT 权限。创建数据源
操作步骤
1. 登录 DataBuddy 控制台。
2. 在顶部切换到目标地域和 Workspace。
3. 进入 数据集成 > 数据源管理（或 平台管理 > 数据源管理）。
4. 点击 添加数据源，选择 GaussDB。
5. 填写连接配置与认证信息，详见 参数说明。
6. 点击 连通性测试（参见 数据源连通性测试）。
7. 测试通过后点击 保存 或 保存 & 创建任务。
参数说明
参数 | 说明 | 是否必填 | 默认值 |
数据源名称 | 数据源在工作空间内的唯一标识 | 是 | - |
JDBC URL | 连接串，格式 jdbc:postgresql://host:port/database | 是 | - |
用户名 | 数据库连接账号 | 是 | - |
密码 | 数据库连接密码（支持 SSM 凭证托管） | 是 | - |
高级参数 | 连接级扩展参数 | 否 | - |
在数据接入任务中使用
离线单表
配置项 | 说明 |
数据来源 | 已配置的 GaussDB 数据源 |
模式 / 表 | 支持指定与正则匹配 |
切割键 | 仅支持整型字段；建议选择主键或带索引的列 |
筛选条件 | 标准 WHERE 语法，支持时间参数 |
最佳实践
实践 | 建议 |
账号权限最小化 | 为同步任务创建专用账号，仅授必要权限 |
切割键选择 | 主键或索引列，避免无索引列导致全表扫描 |
网络打通 | 优先使用内网连接，提升传输性能 |
常见问题
Q：连接超时或被拒绝？
A：检查网络连通性与安全组规则，确认目标实例端口（默认 5432）已放通。
Q：读取大表时速度较慢？
A：设置合理的切割键以并行读取；确认切割键列上有索引。
