# 获取驱动jar包并配置JDK环境 环境准备包括获取驱动jar包、配置JDK环境。 #### 获取驱动包 下载[表1]中的驱动包和驱动包校验包。 表1驱动包下载列表 | 版本 | 下载地址 | |:---|:---| | V2.0-8.x | [驱动包](https://dbs-download.obs.cn-north-1.myhuaweicloud.com/GaussDB/1772024234272/GaussDB_driver.zip) [驱动包校验包](https://dbs-download.obs.cn-north-1.myhuaweicloud.com/GaussDB/1772024234272/GaussDB_driver.zip.sha256) | 为了防止软件包在传递过程或存储期间被恶意篡改，下载软件包时需下载对应的校验包对软件包进行校验，校验方法如下： - Linux操作系统软件包完整性校验： 1. 上传软件包和软件包校验包到虚拟机的同一目录下。 2. 执行如下命令，校验软件包完整性。 **cat** *GaussDB_driver.zip.sha256* **\| sha256sum --check** 如果回显OK，则校验通过。 ``` GaussDB_driver.zip: OK ``` - Windows操作系统软件包完整性校验： 1. 使用快捷键"Win+R"打开"运行"窗口。 在"打开"栏，输入"cmd"，按"Enter"回车，打开命令行页面。 2. 执行以下命令，获取驱动包的Hash值。 certutil -hashfile *{* *驱动包本地目录* *}* \\*{驱动包名}* sha256 - {*驱动包本地目录*}：请根据实际下载目录进行替换。例如：C:\\Users - {*驱动包*名}：请根据实际下载的驱动包名进行替换。例如：GaussDB_driver.zip 示例：certutil -hashfile C:\\Users\\GaussDB_driver.zip sha256 3. 将[2]获取到的Hash值和[表1]中获取到的驱动包校验包的Hash值进行比较。 - 若一致则通过校验。 - 若不一致，请重新下载驱动包，重复[1]\~[3]进行校验。 #### 解压驱动包 以下介绍了选择发布包和驱动jar包的指引步骤： 1. 联系管理员获取GaussDB_driver包，该包包含了多种不同的驱动jar包，可根据后续步骤确定所需驱动jar包的文件路径。驱动jar包的文件层级关系参考以下结构。 GaussDB_driver/数据库部署形态/操作系统架构/驱动类型/驱动jar包 2. JDBC驱动包不区分部署形态，可以选择任意一种数据库部署形态对应的驱动jar包。 3. 操作系统架构选择。 1. 非密态功能不依赖系统架构，可以任意选择一种操作系统。 2. 密态功能需要严格选择对应系统架构的目录，可使用以下命令查看系统架构。 ``` uname -a ``` 4. 驱动类型选择。 选择业务需要的驱动，选择JDBC的压缩包。 5. 用户根据自身业务需求选择对应的驱动包。 解压发布包可获取不同兼容性的驱动jar包，除了gscejdbc.jar、gaussdbjdbc-JRE7.jar之外的所有驱动jar包功能一致，只有Driver主类名、连接串前缀及内部类路径有所区别，具体参见[表2 驱动jar包介绍]。 表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环境使用此驱动包。 | ![](https://support.huaweicloud.com/distributed-devg-v8-gaussdb/public_sys-resources/notice_3.0-zh-cn.png) - 不能使用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为例，配置方法如下。 1. 在DOS窗口（Windows下的命令提示符）输入以下命令查看JDK版本。 ``` java -version ``` 确认为JDK1.8版本。如果未安装JDK，请从[官方网站](https://www.oracle.com/java/technologies/downloads/#java8-linux)下载安装包并安装。 2. 根据如下步骤配置系统环境变量。 1. 右键单击"我的电脑"，选择"属性"。 2. 在"系统"页面左侧导航栏单击"高级系统设置"。 3. 在"系统属性"页面，"高级"页签上单击"环境变量"。 4. 在"环境变量"页面上，"系统变量"区域单击"新建"或"编辑"配置系统变量。变量说明如[表3]所示。 表3变量说明 | 变量名 | 操作 | 变量值 | |:---|:---|:---| | JAVA_HOME | - 若存在，则单击"编辑"。 - 若不存在，则单击"新建"。 | JAVA的安装目录。 例如：C:\\Program Files\\Java\\jdk1.8.0_131 | | Path | 单击"编辑"。 | - 若配置了JAVA_HOME，则在变量值的最前面加上： %JAVA_HOME%\\bin - 若未配置JAVA_HOME，则在变量值的最前面加上 JAVA安装的全路径： C:\\Program Files\\Java\\jdk1.8.0_131\\bin | | CLASSPATH | 单击"新建"。 | %JAVA_HOME%\\lib;%JAVA_HOME%\\lib\\tools.jar |