更新时间:2025-07-07 GMT+08:00
获取驱动jar包并配置JDK环境
环境准备包括获取驱动jar包、配置JDK环境。
获取驱动包
下载表1中的驱动包和驱动包校验包。
为了防止软件包在传递过程或存储期间被恶意篡改,下载软件包时需下载对应的校验包对软件包进行校验,校验方法如下:
- Linux操作系统软件包完整性校验:
- Windows操作系统软件包完整性校验:
解压驱动包
解压获取到的驱动包,找到名为GaussDB-Kernel_数据库版本号_操作系统_64bit_Jdbc.tar.gz的JDBC驱动包并解压,解压后,可获得以下驱动jar包:
- opengaussjdbc.jar:主类名为“com.huawei.opengauss.jdbc.Driver”,数据库连接的url前缀为“jdbc:opengauss”,推荐使用此驱动包。本章的Java代码示例默认使用opengaussjdbc.jar包。如果遇到同一JVM进程内需要同时访问PG及GaussDB的场景,请使用此驱动包。
- gsjdbc4.jar:主类名为“org.postgresql.Driver”,数据库连接的url前缀为“jdbc:postgresql”,该驱动包适用于从PG数据库迁移业务的场景,驱动类和加载路径与迁移前保持一致,但接口支持情况不完全一致,未支持的接口需要业务侧进行调整。
- gscejdbc.jar:主类名为“com.huawei.gaussdb.jdbc.Driver”,数据库连接的url前缀为“jdbc:gaussdb”,此驱动包打包了密态数据库需要加载的加解密相关的依赖库,密态场景推荐使用此驱动包,目前仅支持EulerOS操作系统。使用gscejdbc.jar驱动包时,需要先设置环境变量LD_LIBRARY_PATH。具体使用方式参见《特性指南》中“设置密态等值查询 > 使用JDBC操作密态数据库”章节。
- gsjdbc200.jar:主类名为“com.huawei.gauss200.jdbc.Driver”,数据库连接的url前缀为“jdbc:gaussdb”,该驱动包适用于从Gauss200迁移业务的场景,驱动类和加载路径与迁移前保持一致,但接口支持情况不完全一致,未支持的接口需要业务侧进行调整。

- 各驱动包只是驱动类加载路径和url前缀不同,接口功能上相同。
- jdbc发布件jar包按照架构分类,gscejdbc.jar包必须与对应的部署环境一致才能使用,其他jar包无需与部署环境一致。
- 不能使用gsjdbc4的驱动包操作PG数据库,虽然部分版本能够建连成功,但部分接口行为与PG JDBC不同,可能导致未知错误。
- 不能使用PG的驱动包操作GaussDB数据库,虽然部分版本能够建连成功,但部分接口行为与GaussDB JDBC不同,可能导致未知错误。
配置JDK环境
客户端需配置JDK1.8。JDK是跨平台的,支持Windows、Linux等多种平台。以Windows为例,配置方法如下。
父主题: 开发步骤