
# 获取驱动jar包并配置JDK环境
环境准备包括获取驱动jar包、配置JDK环境。
#### 获取驱动jar包
解压发布包，并从中获取对应的驱动jar包：Jdk8发布包提供支持JDK1.8环境的驱动包；Jdk17发布包提供支持JDK17环境的驱动包；Jdk21发布包提供支持JDK21环境的驱动包。
Jdk8发布包目录结构（以X86为例）如下：
- GaussDB-Kernel_数据库版本号_Jdbc_X86_Jdk8_Distributed.tar.gz
  - GaussDB-Kernel_数据库版本号_操作系统_64bit_Jdbc.tar.gz
    - gaussdbjdbc.jar
    
    - gscejdbc.jar
    
    - gsjdbc4.jar
    
    - gsjdbc200.jar
    
    - opengaussjdbc.jar
    
    - opengaussjdbc-ce.jar
     
   
 
Jdk17发布包目录结构（以X86为例）如下：
- GaussDB-Kernel_数据库版本号_Jdbc_X86_Jdk17_Distributed.tar.gz
  - GaussDB-Kernel_数据库版本号_操作系统_64bit_Jdbc.tar.gz
    - gaussdbjdbc.jar
    
    - gscejdbc.jar
    
    - gsjdbc4.jar
    
    - gsjdbc200.jar
    
    - opengaussjdbc.jar
    
    - opengaussjdbc-ce.jar
     
   
Jdk21发布包目录结构（以X86为例）如下：
- GaussDB-Kernel_数据库版本号_Jdbc_X86_Jdk21_Distributed.tar.gz
  - GaussDB-Kernel_数据库版本号_操作系统_64bit_Jdbc.tar.gz
    - gaussdbjdbc.jar
    
    - gscejdbc.jar
    
    - gsjdbc4.jar
    
    - gsjdbc200.jar
    
    - opengaussjdbc.jar
    
    - opengaussjdbc-ce.jar
     
   
 
根据需要从发布包中获取对应的jar驱动包：
- 对于JDK1.8环境，使用Jdk8的发布包：
  - gaussdbjdbc.jar：主类名为"com.huawei.gaussdb.jdbc.Driver"，数据库连接的url前缀为"jdbc:gaussdb"，此驱动包适用于JDK1.8环境。
  
  - gscejdbc.jar：主类名为"com.huawei.gaussdb.jdbc.Driver"，数据库连接的url前缀为"jdbc:gaussdb"，此驱动包打包了密态数据库需要加载的加解密相关的依赖库，密态场景使用此驱动包。目前仅支持EulerOS操作系统。
   
- 对于JDK17环境，使用Jdk17的发布包：
  - gaussdbjdbc.jar：主类名为"com.huawei.gaussdb.jdbc.Driver"，数据库连接的url前缀为"jdbc:gaussdb"，此驱动包适用于JDK17环境。
  
  - gscejdbc.jar：主类名为"com.huawei.gaussdb.jdbc.Driver"，数据库连接的url前缀为"jdbc:gaussdb"，此驱动包包含密态数据库所需的加解密依赖库，密态场景使用此驱动包。目前仅支持EulerOS操作系统。
   
- 对于JDK21环境，使用Jdk21的发布包：
  - gaussdbjdbc.jar：主类名为"com.huawei.gaussdb.jdbc.Driver"，数据库连接的url前缀为"jdbc:gaussdb"，此驱动包适用于JDK21环境。
  
  - gscejdbc.jar：主类名为"com.huawei.gaussdb.jdbc.Driver"，数据库连接的url前缀为"jdbc:gaussdb"，此驱动包包含密态数据库所需的加解密依赖库，密态场景使用此驱动包。目前仅支持EulerOS操作系统。
   
![](https://support.huaweicloud.com/distributed-devg-v10-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
- 使用gscejdbc.jar驱动包时，需要先设置环境变量LD_LIBRARY_PATH。具体使用方式参见[使用JDBC操作密态数据库](https://support.huaweicloud.com/distributed-devg-v10-gaussdb/gaussdb-12-0377.html)。
- jdbc发布件jar包按照架构分类，gscejdbc.jar包必须与对应的部署环境一致才能使用，其他jar包无需与部署环境一致。
- Jdk17和Jdk21发布包的驱动暂不支持JDBC4.3标准新特性。
 
#### 配置JDK环境
客户端需配置JDK环境，本章节以配置JDK1.8为例。JDK支持Windows、Linux等多种平台。以Windows为例，配置方法如下。
1. 在DOS窗口（Windows下的命令提示符）输入以下命令查看JDK版本。 
   ```
   java -version
   ```
   确认是否已安装JDK1.8。若未安装，请从[官方网站](https://www.oracle.com/java/technologies/downloads/#java8-linux)下载安装包并安装。
   
   
2. 根据如下步骤配置系统环境变量。 
   1. 右键单击"我的电脑"，选择"属性"。
   
   2. 在"系统"页面左侧导航栏单击"高级系统设置"。
      ![](https://support.huaweicloud.com/distributed-devg-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
      因操作系统版本之间存在差异，操作时请以实际路径为准。
      
   
   3. 在"系统属性"页面，"高级"页签上单击"环境变量"。
   
   4. 在"环境变量"页面上，"系统变量"区域单击"新建"或"编辑"配置系统变量。变量说明如[表1]所示。
       表1变量说明 
      | **变量名**   | **操作**                                                                                                                                                                                                                                                                           | **变量值**                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
      |:---|:---|:---|
      | 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。                                                                                                                                                                                                                                                                                                                                                                                                           |
         
      
   
   
   
   
 
