获取驱动jar包并配置JDK环境
环境准备包括获取驱动jar包、配置JDK环境。
获取驱动包
下载表1中的驱动包和驱动包校验包。
- Linux操作系统软件包完整性校验：
- Windows操作系统软件包完整性校验：
解压驱动包
以下介绍了选择发布包和驱动jar包的指引步骤：
- 联系管理员获取GaussDB_driver包，该包包含了多种不同的驱动jar包，可根据后续步骤确定所需驱动jar包的文件路径。驱动jar包的文件层级关系参考以下结构。
GaussDB_driver/数据库部署形态/操作系统架构/驱动类型/驱动jar包
- JDBC驱动包不区分部署形态，可以选择任意一种数据库部署形态对应的驱动jar包。
- 操作系统架构选择。
- 非密态功能不依赖系统架构，可以任意选择一种操作系统。
- 密态功能需要严格选择对应系统架构的目录，可使用以下命令查看系统架构。
uname -a
- 驱动类型选择。
选择业务需要的驱动，选择JDBC的压缩包。
- 用户根据自身业务需求选择对应的驱动包。
解压发布包可获取不同兼容性的驱动jar包，除了gscejdbc.jar、gaussdbjdbc-JRE7.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操作系统。
gaussdbjdbc-JRE7.jar
jdbc:gaussdb
com.huawei.gaussdb.jdbc.Driver
JDK1.7环境使用此驱动包。
- 不能使用gsjdbc4的驱动包操作PG数据库，虽然部分版本能够建连成功，但部分接口行为与PG JDBC不同，可能导致未知错误。
- 不能使用PG的驱动包操作GaussDB数据库，虽然部分版本能够建连成功，但部分接口行为与GaussDB JDBC不同，可能导致未知错误。
- 使用gscejdbc.jar驱动包时，需要先设置环境变量LD_LIBRARY_PATH。具体使用方式参见《特性指南》中“设置密态等值查询 > 使用JDBC操作密态数据库”章节。
- 在JDK1.8环境中使用gaussdbjdbc.jar，不推荐使用gaussdbjdbc-JRE7.jar。
- jdbc发布件jar包按照架构分类，gscejdbc.jar包必须与对应的部署环境一致才能使用，其他jar包无需与部署环境一致。
- 由于JDK7本身的限制，JDK7发布包的驱动不支持以下接口或功能：
- java.time包下所有日期类型的使用。
- AES加解密操作。
配置JDK环境
客户端需配置JDK环境，当前支持JDK1.8和JDK1.7版本，本章节以配置JDK1.8为例。JDK支持Windows、Linux等多种平台。以Windows为例，配置方法如下。
