# 获取驱动jar包并配置JDK环境
环境准备包括获取驱动jar包、配置JDK环境。
#### 获取驱动包
下载[表1]中的驱动包和驱动包校验包。
 表1驱动包下载列表 
| 版本       | 下载地址                                                                                                                                                                                                                                                                                                                          |
|:---|:---|
| V2.0-3.x | [驱动包](https://dbs-download.obs.cn-north-1.myhuaweicloud.com/GaussDB/1716950374370/GaussDB_driver.zip) [驱动包校验包](https://dbs-download.obs.cn-north-1.myhuaweicloud.com/GaussDB/1716950374370/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]进行校验。
      
   
 
#### JDBC包
解压获取到的驱动包，找到名为GaussDB-Kernel_数据库版本号_操作系统_64bit_Jdbc.tar.gz的JDBC驱动包并解压，解压后，可获得以下驱动jar包：
- opengaussjdbc.jar：主类名为"com.huawei.opengauss.jdbc.Driver"，数据库连接的url前缀为"jdbc:opengauss"，推荐使用此驱动包。如果遇到同一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迁移业务的场景，驱动类和加载路径与迁移前保持一致，但接口支持情况不完全一致，未支持的接口需要业务侧进行调整。
  ![](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
  - 各驱动包只是驱动类加载路径和url前缀不同，接口功能上相同。
  
  - jdbc发布件jar包按照架构分类，gscejdbc.jar包必须与对应的部署环境一致才能使用，其他jar包无需与部署环境一致。
  
  - 不能使用gsjdbc4的驱动包操作PG数据库，虽然部分版本能够建连成功，但部分接口行为与PG JDBC不同，可能导致未知错误。
  
  - 不能使用PG的驱动包操作GaussDB数据库，虽然部分版本能够建连成功，但部分接口行为与GaussDB JDBC不同，可能导致未知错误。
    
 
#### 配置JDK环境
客户端需配置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. 在"环境变量"页面上，"系统变量"区域单击"新建"或"编辑"配置系统变量。变量说明如[表2]所示。
       表2变量说明 
      | **变量名**   | **操作**                                                                                                                                                                                                                                                                                                                                                                                                                            | **变量值**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
      |:---|:---|:---|
      | 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                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |