更新时间：2026-03-04 GMT+08:00
下载JDBC或ODBC驱动
JDBC或ODBC驱动程序用于连接DWS集群，用户可以在管理控制台下载DWS提供的JDBC或ODBC驱动程序，也可以使用开源的JDBC或ODBC驱动程序。
支持的开源JDBC或ODBC驱动程序
DWS也支持开源的JDBC驱动程序：PostgreSQL JDBC驱动程序9.3-1103或更高版本。
DWS也支持开源的ODBC驱动程序：PostgreSQL ODBC 09.01.0200或更高版本。
下载JDBC驱动程序
- 登录DWS管理控制台。
- 在左侧导航栏中，选择 “专属集群 > 管理 > 连接客户端”。
- 在“下载驱动程序”区域，选择相应的版本，然后单击“下载”可以下载与集群版本匹配的JDBC驱动。
下拉框选择“DWS JDBC Driver”，然后单击“下载”可以下载与现有集群版本匹配的JDBC驱动。驱动包名为“dws_9.1.x_jdbc_driver.zip”，解压后有两个JDBC的驱动jar包，分别为“gsjdbc4.jar”和“gsjdbc200.jar”。JDBC驱动包支持在所有平台所有版本中使用，且依赖JDK 1.8.0及以上版本。
- gsjdbc4.jar：与PostgreSQL保持兼容，其中类名、类结构与PostgreSQL驱动完全一致，曾经运行于PostgreSQL的应用程序可以直接移植到当前系统中使用。
- gsjdbc200.jar：如果同一JVM进程内需要同时访问PostgreSQL及DWS请使用该驱动包。该包主类名为“com.huawei.gauss200.jdbc.Driver”（即将“org.postgresql”替换为“com.huawei.gauss200.jdbc”） ，数据库连接的URL前缀为“jdbc:gaussdb”，其余与gsjdbc4.jar相同。
如果同时拥有不同版本的集群，单击“下载”时会下载与集群最低版本相对应的JDBC驱动。如果当前没有集群，单击“下载”时将下载到低版本的JDBC驱动。DWS集群可向下兼容低版本的JDBC驱动。单击“历史版本”可根据集群版本下载相应版本的JDBC驱动，建议按集群版本进行下载。
如果同时拥有不同版本的集群，系统会弹出对话框，提示您选择“集群版本”然后下载与集群版本相对应的驱动程序。在“专属集群”页面的集群列表中，单击指定集群的名称，再选择“集群详情”页签，可查看集群版本。
表1 JDBC驱动下载地址 驱动名称
下载地址
校验文件
DWS JDBC Driver
DWS ARM JDBC Driver
- （可选方式二）用户还可通过配置maven仓库的方式下载SDK包。
- 进入Maven仓库：
- 在图1所示的列表中的版本号代表DWS JDBC驱动包的版本号，用户可根据需求选择相应版本的驱动包（理论上DWS集群兼容JDBC任何版本，但新版本会不断优化并修复已知问题，所以推荐使用最新版本，JDBC版本详情请参见JDBC版本说明），其中“gsjdbc200.jar”驱动jar包对应的版本号带有“x.x.x-200”后缀。然后单击指定版本号进入以下页面：
图2 Maven项目依赖
- 复制页面下方Maven库信息，并将其添加到pom.xml文件中。例如，在pom.xml文件中添加JDBC 8.5.1版本的驱动信息，如下代码所示：
- gsjdbc4.jar
1 2 3 4 5
<dependency> <groupId>com.huaweicloud.dws</groupId> <artifactId>huaweicloud-dws-jdbc</artifactId> <version>8.5.1</version> </dependency>
- gsjdbc200.jar
<dependency> <groupId>com.huaweicloud.dws</groupId> <artifactId>huaweicloud-dws-jdbc</artifactId> <version>8.5.1-200</version> </dependency>
- gsjdbc4.jar
- （可选方式三）用户还可通过配置gradle配置依赖。
参考方法二获取Maven库信息，配置到gradle配置文件中。
- gsjdbc4.jar
1implementation("com.huaweicloud.dws:huaweicloud-dws-jdbc:8.5.1") - gsjdbc200.jar
implementation("com.huaweicloud.dws:huaweicloud-dws-jdbc:8.5.1-200")
- gsjdbc4.jar
下载ODBC驱动
- 登录DWS管理控制台。
- 在左侧导航栏中，选择 “专属集群 > 管理 > 连接客户端”。
- 在“下载驱动程序”区域，选择相应的版本，然后单击“下载”可以下载与集群版本匹配的ODBC驱动。ODBC驱动不兼容Window server 2016系统。
如果同时拥有不同版本的集群，单击“下载”时会下载与集群最低版本相对应的ODBC驱动。如果当前没有集群，单击“下载”时将下载到低版本的ODBC驱动。DWS集群可向下兼容低版本的ODBC驱动。单击“历史版本”可根据操作系统和集群版本下载相应版本的ODBC驱动，建议按集群版本进行下载。
表2 ODBC驱动下载地址 适用操作系统
下载地址
校验文件
Windows
Euler ARM
Redhat ARM
Redhat x86_64
SUSE x86_64
