直接用 PostgreSQL 驱动连 GaussDB 大概率失败，因 GaussDB 做了协议扩展（如 SCRAM-SHA-256 认证、gs_role 权限模型、pgxc_class 系统表等），必须使用华为官方驱动（如 gsjdbc4.jar 或 huaweicloud-dws-jdbc.jar）并配置 sslmode=verify-full、ApplicationName 等参数。
直接用 PostgreSQL 驱动连 GaussDB 大概率失败，不是配置错，而是驱动不兼容——GaussDB（尤其华为云 GaussDB for DWS 或 openGauss）虽兼容 PostgreSQL 协议，但官方明确要求使用 huaweicloud-dws-jdbc 或 gsjdbc4.jar 等专用驱动，否则会遇到 No suitable driver found、Unknown function: current_schema()、SSL 握手失败等隐性问题。
为什么不能直接选 PostgreSQL 驱动？
PostgreSQL 官方驱动（postgresql-42.x.jar）只认标准协议行为，而 GaussDB 在以下方面做了扩展或修改：
-
current_schema()、pg_backend_pid()等函数返回值或行为不一致，导致 DBeaver 元数据加载失败、表结构无法展开 - 部分 GaussDB 版本强制要求 SSL 重协商，PostgreSQL 驱动默认不支持
- 高斯特有的系统表（如
pgxc_class）、分布式执行计划视图无法识别 - 连接字符串中若含
options=-c%20search_path=public类参数，PostgreSQL 驱动会解析失败
必须手动添加 GaussDB 官方 JDBC 驱动
别依赖 DBeaver 的“自动下载”或“PostgreSQL 驱动管理器”，它不会给你装对的驱动。正确做法是：
- 从华为云文档页下载对应版本的驱动包（如
huaweicloud-dws-jdbc-8.2.0.jar），或从 openGauss 官网获取gsjdbc4.jar - 在 DBeaver 中打开 数据库 → 驱动管理器 → 新建 → Generic（不要选 PostgreSQL）
- 填写关键字段：
– 驱动名称：填GaussDB-DWS或openGauss（便于区分）
– 类名：org.postgresql.Driver（注意：仍是这个类名，不是自定义类）
– URL 模板：jdbc:postgresql://{host}[:{port}]/[{database}]（保持和 PostgreSQL 一致，GaussDB 兼容该格式）
– 默认端口：5432（集中式）或25308（MPP 分布式 CN 端口，需查postgresql.conf） - 点击“库”页签 → “添加文件” → 选中你下载的
huaweicloud-dws-jdbc-8.2.0.jar（不是postgresql-42.x.jar）
测试连接前必须确认的三件事
即使驱动和 URL 都对，连不上大概率卡在这三个地方：
-
实例网络可达：主机 IP 必须是 GaussDB 实例的
弹性公网IP（华为云）或 CN 节点内网 IP（本地集群），且安全组/防火墙放行对应端口（非仅 5432） -
pg_hba.conf 已配允许访问：在 CN 节点上编辑
pg_hba.conf，加一行类似：host all all 10.10.0.30/32 md5，然后执行gs_om -t reload -
用户有 CONNECT 权限：用
omm或管理员账号登录后，执行：CREATE USER myuser WITH PASSWORD 'xxx'; GRANT CONNECT ON DATABASE postgres TO myuser;（postgres替换为实际库名）
连接成功后仍看不到表？检查元数据加载设置
DBeaver 默认启用“延迟加载元数据”，GaussDB 的系统表结构较复杂，容易卡住或报错。解决方法：
- 右键已连接的数据库 → 编辑连接设置 → 初始化 → 取消勾选 “Read catalog and schema list on connect”
- 进入 连接设置 → 驱动属性，添加两项：
–preferQueryMode=extended
–reWriteBatchedInserts=true（提升批量操作兼容性） - 首次展开
publicschema 时，耐心等 5–10 秒；若仍空白，右键 schema → “刷新对象”
最易被忽略的是：GaussDB 的 pg_hba.conf 修改后必须 reload（不是 restart），且驱动 jar 文件一旦加入驱动管理器，DBeaver 不会自动检测更新——换新版本驱动时，要先删旧驱动再重新导入，否则 Test Connection 成功但后续操作异常。
