获取驱动jar包并配置JDK环境
环境准备包括获取驱动jar包、配置JDK环境。
获取驱动包
下载表1中的驱动包和驱动包校验包。
- Linux操作系统软件包完整性校验：
- 上传软件包和软件包校验包到虚拟机的同一目录下。
- 执行如下命令，校验软件包完整性。
F=$(echo DBS-GaussDB-driver*.tar.gz);echo "$(awk '{print $1}' "$F.sha256") $F" | sha256sum -c -如果回显OK，则校验通过。例如：
DBS-GaussDB-driver_507.0_20260629130806.133858239.tar.gz: OK
- Windows操作系统软件包完整性校验：
- 使用快捷键“Win+R”打开“运行”窗口。 在“打开”栏，输入“cmd”，按“Enter”回车，打开命令行页面。
- 执行以下命令，获取驱动包的Hash值。
certutil -hashfile {驱动包本地目录}\{驱动包名} sha256
- {驱动包本地目录}：请根据实际下载目录进行替换。例如：C:\Users
- {驱动包名}：请根据实际下载的驱动包名进行替换。例如：DBS-GaussDB-driver_507.0_20260629130806.133858239.tar.gz
示例：certutil -hashfile C:\Users\DBS-GaussDB-driver_507.0_20260629130806.133858239.tar.gz sha256
- 将2获取到的Hash值和表1中获取到的驱动包校验包的Hash值进行比较。
获取驱动jar包
以下介绍了获取驱动jar包的步骤：
- 解压获取到的驱动包。该包包含多种不同的驱动jar包，可根据后续步骤确定所需驱动jar包的文件路径。驱动jar包的文件层级关系参考以下结构。
DBS-GaussDB-driver_*/数据库部署形态/驱动类型/操作系统架构/发布包/驱动jar包
- 选择数据库部署形态。
JDBC驱动包不区分部署形态，可选择Centralized/Distributed任意一种数据库部署形态对应的驱动jar包。
- 选择驱动类型。
选择jdbc_driver.tar.gz，并解压。
- 选择操作系统架构。 非透明多写特性下：
- 非密态功能不依赖系统架构，可选择任意一种操作系统架构。
- 密态功能需要严格选择对应系统架构的目录，可使用以下命令查看客户端系统架构。
uname -a
- 选择发布包。 使用以下命令查看当前环境的JDK版本，然后选择与当前环境JDK适配的发布包。
java -version
- JDK8发布包中包含适配JDK1.8的驱动jar包。
- JDK17发布包中包含适配JDK17的驱动jar包。
- JDK21发布包中包含适配JDK21的驱动jar包。
- 用户根据自身业务需求选择对应的驱动包。
- 推荐用户在非密态场景下使用gaussdbjdbc.jar，在密态场景下使用gscejdbc.jar。opengaussjdbc-ce.jar、opengaussjdbc.jar、gsjdbc4.jar和gsjdbc200.jar后续将不再维护。
- 非密态场景下，gaussdbjdbc.jar兼容opengaussjdbc.jar、gsjdbc4.jar和gsjdbc200.jar，用户使用gaussdbjdbc.jar替换opengaussjdbc.jar、gsjdbc4.jar或gsjdbc200.jar时， 无需修改jdbc相关业务代码。
- 密态场景下，gscejdbc.jar兼容opengaussjdbc-ce.jar，用户使用gscejdbc.jar替换opengaussjdbc-ce.jar时， 无需修改jdbc相关业务代码。
解压发布包可获取不同兼容性的驱动jar包，除了gscejdbc.jar、opengaussjdbc-ce.jar之外的所有驱动jar包功能一致，只有Driver主类名、连接串前缀及内部类路径有所区别，具体参见表2。表2 驱动jar包介绍 驱动包
连接串前缀
Driver主类名
适用场景
gaussdbjdbc.jar
jdbc:gaussdb
com.huawei.gaussdb.jdbc.Driver
本章的Java代码示例默认使用gaussdbjdbc.jar包。非密态数据库场景下，优先推荐使用此驱动包。
opengaussjdbc.jar
jdbc:opengauss
com.huawei.opengauss.jdbc.Driver
遇到同一JVM进程内需要同时访问PG及GaussDB的场景，请使用此驱动包。
gsjdbc4.jar
jdbc:postgresql
org.postgresql.Driver
此驱动包适用于从PG数据库迁移业务的场景，驱动类和加载路径与迁移前保持一致，但接口支持情况不完全一致，未支持的接口需要业务侧进行调整。
gsjdbc200.jar
jdbc:gaussdb
com.huawei.gauss200.jdbc.Driver
该驱动包适用于从Gauss200迁移业务的场景，驱动类和加载路径与迁移前保持一致，但接口支持情况不完全一致，未支持的接口需要业务侧进行调整。其余与gsjdbc4.jar相同。
gscejdbc.jar
jdbc:gaussdb
com.huawei.gaussdb.jdbc.Driver
此驱动包包含密态数据库需要加载的加解密相关的依赖库，因此密态数据库场景下推荐使用此驱动包。目前仅支持Euler和HCE操作系统。
opengaussjdbc-ce.jar
jdbc:opengauss
com.huawei.opengauss.jdbc.Driver
该驱动包包含密态数据库需要加载的加解密相关的依赖库，url前缀为“jdbc:opengauss”的密态数据库场景下推荐使用此驱动包。目前仅支持Euler和HCE操作系统。
- 不能使用GaussDB的驱动包操作PG数据库，虽然部分版本能成功连接，但部分接口行为与PG JDBC不兼容，可能导致未知错误。
- 不能使用PG的驱动包操作GaussDB数据库，虽然部分版本能成功连接，但部分接口行为与GaussDB JDBC不兼容，可能导致未知错误。
- 使用gscejdbc.jar驱动包时，需要先设置环境变量LD_LIBRARY_PATH，具体设置方式请参见使用JDBC操作密态数据库。
- 在运行环境中添加驱动jar包。
例如在非密态数据库场景下，用户使用IDE进行开发，则在本地IDE添加gaussdbjdbc.jar包（优先推荐）。
配置JDK环境
客户端需配置JDK环境，JDK支持Windows、Linux等多种平台。本章节以配置JDK1.8和Windows11平台为例，给出具体步骤。
