最新动态
功能总览
服务公告
- 产品公告
- 版本支持公告
产品介绍
- 图解数据仓库服务
- 什么是数据仓库服务
- 数据仓库类型
- 数据仓库规格
- 产品优势
- 应用场景
- 产品功能
- 基本概念
- 与其他云服务的关系
- 安全
- GaussDB(DWS)权限管理
- 如何访问GaussDB(DWS)
- 使用限制
- 技术支持
- 配额说明
- GaussDB(DWS)技术指标
计费说明
- GaussDB(DWS)计费概述
- 计费模式
- 计费项
- 计费样例
- 变更计费模式
- 续费
  - 续费概述
  - 手动续费
- 费用账单
- 欠费说明
- 停止计费
- 成本管理
- 计费FAQ
快速入门
- 免费体验GaussDB(DWS)
- 快速创建GaussDB(DWS)集群并导入数据进行查询
- GaussDB(DWS)数据开发SQL入门操作
- GaussDB(DWS)入门实践
用户指南
- GaussDB(DWS)使用流程
- 准备工作
- 创建GaussDB(DWS)集群
- 连接GaussDB(DWS)集群
- 创建GaussDB(DWS)数据库和用户
- 迁移业务数据至GaussDB(DWS)集群
  - 使用GDS-Kafka工具迁移数据至GaussDB(DWS)集群
  - 管理数据源
- GaussDB(DWS)集群数据安全与加密
- GaussDB(DWS)集群管理
- GaussDB(DWS)集群运维
最佳实践
- 导入导出
- 数据迁移
- 数据分析
- 存算分离
  - GaussDB(DWS) 3.0 存算分离使用建议及性能优化
- 数据开发
- 数据库管理
- 性能调优
  - 基于表结构设计和调优提升GaussDB(DWS)查询性能
  - 分析正在执行的SQL以处理GaussDB(DWS)业务阻塞
- 集群管理
  - 为两种作业绑定不同资源池以实现GaussDB(DWS)资源负载能力
  - GaussDB(DWS)存算一体架构弹性伸缩系统性介绍
数据迁移与同步
- 迁移数据到GaussDB(DWS)
- 导入数据
- 整库迁移
  - 使用CDM迁移数据到GaussDB(DWS)
  - 使用DSC工具迁移SQL脚本
- 实时入库
  - Kafka实时入库到GaussDB(DWS)
- 元数据迁移
  - 使用gs_dump和gs_dumpall命令导出元数据
  - 使用gs_restore导入数据
- 导出数据
- 其他操作
开发指南
- 标准数仓开发指南(9.1.0.x)
- 标准数仓开发指南(8.1.3.x)
- 实时数仓开发指南(9.1.0.x)
- 实时数仓开发指南(8.1.3.x)
- 历史版本
SQL语法参考
- SQL语法参考(9.1.0.x)
- SQL语法参考(8.1.3.x)
- 历史版本
工具指南
- 工具简介
- 工具下载
- gsql
- Data Studio
- GDS
- DSC
- DataCheck
- DWS-Connector
- 服务端工具
API参考
- 使用前必读
- API概述
- 如何调用API
- 快速入门
- API说明
- 应用示例
  - 使用Postman调用创建集群接口
  - 使用Postman调用创建快照接口
- 权限及授权项说明
- 附录
SDK参考
- SDK概述
场景代码示例
错误码参考
- 控制台错误码
  - 管理控制台错误码
- 错误码(8.2.0及以下版本)
  - 管理控制台错误码
  - 数据仓库错误码
- 8.2.1及以上版本
  - 错误码命名规范
  - 行列存
    - 行存
    - 列存
    - GIN索引
    - Btree索引
    - 行存vacuum
    - SP-GiST索引
    - Hash索引
  - 事务
    - 锁
    - GTM
    - xlog
    - checkpoint
  - HA
  - SQL on Anywhere
    - SQL on hudi
    - OBS / HDFS / DLI
  - GDS/Copy
    - 公共机制（选项参数、任务分配、压缩）
    - 导入
  - 解析器
    - 词法分析
    - 语法分析
    - DDL
    - DML
    - 表达式
    - 元数据
  - 优化器
  - 执行器
  - 安全
    - 授权
    - 脱敏
  - 通信
  - WLM
  - 逻辑集群
  - 其他
常见问题
- Top问题汇总
- 产品咨询
- 数据库连接
- 数据迁移
- 数据库使用
- 集群管理
- 账户与权限
- 数据库性能
- 备份恢复
  1. 为什么DWS自动快照创建很慢，很长时间都没有创建好？
  2. DWS快照是否与EVS快照功能相同？
故障排除
- 数据库连接管理
- JDBC/ODBC类
- 数据导入/导出
- 数据库参数修改
- 账号/权限/密码
- 集群性能
- 集群异常
  - 磁盘监控告警阈值太低，告警频繁
- 数据库使用
视频帮助
性能白皮书
- 性能白皮书(9.1.0.x)
- 性能白皮书(8.1.3.x)
文档下载
通用参考
- 产品术语
- 云服务等级协议（SLA）
- 白皮书资源
- 支持区域
- 系统权限

本文导读

Check that the hostname and port are correct and that the postmaster is accepting TCP/IP connections.
FATAL: Invalid username/password,login denied.
No suitable driver found for XXXX
conflict
org.postgresql.util.PSQLException: FATAL: terminating connection due to administrator command Session unused timeout
Connection refused: connect.
Connections could not be acquired from the underlying database!
JDBC DEV环境没问题，测试环境连接出错报空指针或URI报错uri is not hierarchical
使用开源JDBC SSL方式连接DWS报错
在CopyManager场景使用连接池获取连接，Connection无法转换为BaseConnection

展开导读

文档首页/ 数据仓库服务 GaussDB(DWS)/ 故障排除/ JDBC/ODBC类/ 建立数据库连接失败

建立数据库连接失败

更新时间：2025-01-15 GMT+08:00

查看PDF

Check that the hostname and port are correct and that the postmaster is accepting TCP/IP connections.

问题分析：客户端与服务端网络不通、端口错误或待连接CN异常。

处理方法：

客户端ping服务端IP，查看网络是否畅通，网络不通则需解决网络问题。
检查URL中连接CN的端口是否正确，若端口不正确则需修改为正确的端口（默认为8000）。

FATAL: Invalid username/password,login denied.

问题分析：用户名或密码配置错误。

处理方法：检查用户名密码是否为数据库用户名和密码，将其修改为正确的数据库用户名和密码。

No suitable driver found for XXXX

问题分析：通过JDBC建连时URL格式错误。

处理方法：将URL格式修改为正确的格式。

gsjdbc4.jar对应URL格式为： jdbc:postgresql://host:port/database
- 在使用pom依赖时对应8.1.x版本
gsjdbc200.jar对应URL格式为：jdbc:gaussdb://host:port/database
- 在使用pom依赖时对应8.1.x-200版本

conflict

问题分析：JDBC jar包和应用程序冲突。例如JDBC和应用程序拥有相同路径相同名称的类导致：

gsjdbc4.jar和开源postgresql.jar冲突，两者具有完全相同的类名。
gsjdbc4.jar由于IAM特性引入了一些其他工具，例如fastjson，和应用程序中的fastjson冲突。

处理方法：

针对和开源postgresql.jar的冲突，DWS提供了gsjdbc200.jar，使用和开源驱动不同的url格式和驱动路径，驱动名由org.postgresql.Driver修改为com.huawei.gauss200.jdbc.Driver，URL格式由org:postgresql://host:port/database改为jdbc:gaussdb://host:port/database，彻底解决了和开源jar包的冲突。
针对JDBC引入的jar和应用程序中引入jar的冲突，可以通过maven的shade修改了jar中类的路径，解决此类冲突。
排查使用的JDBC驱动是gsjdbc4.jar还是gsjdbc200.jar，如果是gsjdbc4.jar应该替换为gsjdbc200.jar，尝试建立连接。

说明：

对于pom依赖，将8.1.x版本替换为8.1.x-200版本。

org.postgresql.util.PSQLException: FATAL: terminating connection due to administrator command Session unused timeout

问题分析：会话超时导致连接断开。

处理方法：排查CN和客户端JDBC上的超时配置，按业务实际情况调长超时时间或关闭超时设置。

查看报错的CN日志，如果有session unused timeout这样的日志，说明是会话超时导致的。

解决办法：
1. 登录GaussDB(DWS)管理控制台。
2. 在左侧导航栏中，单击“专属集群 > 集群列表”。
3. 在集群列表中找到所需要的集群，单击集群名称，进入“集群详情”页面。
4. 单击“参数修改”页签，在“参数列表”中找到“session_timeout”参数查看超时时间。
5. 将session_timeout参数的CN、DN参数值设置为0，关闭超时设置。

Connection refused: connect.

问题分析：第三方工具的默认驱动不兼容。

处理方法：用户可更换JDBC驱动包，查看是否正常连接。

Connections could not be acquired from the underlying database!

问题分析：按照新建连接排查项进行排查：

驱动配置是否有误。
数据库连接地址是否有误。
密码或账号是否有误。
数据库未启动或无权访问。
项目未引入对应的驱动jar包。

处理方法：

排查驱动配置，将其修改为正确的驱动配置。
- gsjdbc4.jar driver=org.postgresql.Driver
- gsjdbc200.jar driver=com.huawei.gauss200.jdbc.Driver
排查数据库连接地址，将其修改为正确的数据库连接地址。
- gsjdbc4.jar对应jdbc:postgresql://host:port/database
- gsjdbc200.jar对应jdbc:gaussdb://host:port/database
排查用户名密码是否为数据库用户名或密码，将其修改为正确的数据库用户名或密码。
排查数据库是否启动或有权限访问。
检查使用的JDBC驱动是gsjdbc4.jar还是gsjdbc200.jar，请使用正确JDBC驱动jar包。
- gsjdbc4.jar：与PostgreSQL保持兼容，其中类名、类结构与PostgreSQL驱动完全一致，曾经运行于PostgreSQL的应用程序可以直接移植到当前系统中使用。
- gsjdbc200.jar：如果同一JVM进程内需要同时访问PostgreSQL及GaussDB(DWS) 请使用该驱动包。该包主类名为“com.huawei.gauss200.jdbc.Driver”（即将“org.postgresql”替换为“com.huawei.gauss200.jdbc”），数据库连接的URL前缀为“jdbc:gaussdb”，其余与gsjdbc4.jar相同。

JDBC DEV环境没问题，测试环境连接出错报空指针或URI报错uri is not hierarchical

问题分析：某些虚拟环境不支持获取扩展参数，需关闭。

处理方法：在连接时可设置连接参数“connectionExtraInfo=false”，详情可参见使用JDBC连接数据库。

    
       jdbc:postgresql://host:port/database?connectionExtraInfo=false

使用开源JDBC SSL方式连接DWS报错

问题分析：使用开源JDBC会进行SSL全校验，校验url是否完全匹配。

处理方法：在开源连接时可设置连接参数“sslmode=require”。

    
       jdbc:postgresql://host:port/database?sslmode=require

在CopyManager场景使用连接池获取连接，Connection无法转换为BaseConnection

问题分析：BaseConnection为非公开类，需要对连接池对象解封装然后获取原始PGConnection。

处理方法：对当前对象解包装，返回原始对象以允许访问未公开方法。

    
       //解封装
PGConnection unwrap = connection.unwrap(PGConnection.class);
//转换BaseConnection
BaseConnection baseConnection = (BaseConnection)unwrap;
CopyManager copyManager = new CopyManager(baseConnection);

父主题： JDBC/ODBC类

上一篇：JDBC问题定位

下一篇：执行业务抛出异常

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

建立数据库连接失败

Check that the hostname and port are correct and that the postmaster is accepting TCP/IP connections.

FATAL: Invalid username/password,login denied.

No suitable driver found for XXXX

conflict

org.postgresql.util.PSQLException: FATAL: terminating connection due to administrator command Session unused timeout

Connection refused: connect.

Connections could not be acquired from the underlying database!

JDBC DEV环境没问题，测试环境连接出错报空指针或URI报错uri is not hierarchical

使用开源JDBC SSL方式连接DWS报错

在CopyManager场景使用连接池获取连接，Connection无法转换为BaseConnection

相关文档

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线

文档反馈