更新时间:2025-06-27 GMT+08:00

获取驱动jar包并配置JDK环境

环境准备包括获取驱动jar包、配置JDK环境。

获取驱动包

下载表1中的驱动包和驱动包校验包。

表1 驱动包下载列表

版本

下载地址

V2.0-8.x

驱动包

驱动包校验包

为了防止软件包在传递过程或存储期间被恶意篡改,下载软件包时需下载对应的校验包对软件包进行校验,校验方法如下:
  • 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进行校验。

解压驱动包

解压获取到的驱动包,找到名为GaussDB-Kernel_数据库版本号_操作系统_64bit_Jdbc.tar.gz的JDBC驱动包并解压,解压后,可获得以下驱动jar包:
  • gaussdbjdbc.jar:主类名为“com.huawei.gaussdb.jdbc.Driver”,数据库连接的url前缀为“jdbc:gaussdb”,推荐使用此驱动包。本章的Java代码示例默认使用gaussdbjdbc.jar包。
  • gscejdbc.jar:主类名为“com.huawei.gaussdb.jdbc.Driver”,数据库连接的url前缀为“jdbc:gaussdb”,此驱动包打包了密态数据库需要加载的加解密相关的依赖库,密态场景推荐使用此驱动包。目前仅支持EulerOS操作系统。
  • gaussdbjdbc-JRE7.jar:主类名为“com.huawei.gaussdb.jdbc.Driver”,数据库连接的url前缀为“jdbc:gaussdb”,在JDK1.7环境使用gaussdbjdbc-JRE7.jar包。
  • 使用gscejdbc.jar驱动包时,需要先设置环境变量LD_LIBRARY_PATH。具体使用方式参见《特性指南》中“设置密态等值查询 > 使用JDBC操作密态数据库”章节。
  • 在JDK1.8环境中使用gaussdbjdbc.jar,不推荐使用gaussdbjdbc-JRE7.jar。
  • jdbc发布件jar包按照架构分类,gscejdbc.jar包必须与对应的部署环境一致才能使用,其他jar包无需与部署环境一致。
  • 其他JDBC的jar包介绍请参见JDBC兼容性包

配置JDK环境

客户端需配置JDK环境,当前支持JDK1.8和JDK1.7版本,本章节以配置JDK1.8为例。JDK支持Windows、Linux等多种平台。以Windows为例,配置方法如下。

  1. 在DOS窗口(Windows下的命令提示符)输入以下命令查看JDK版本。

    java -version

    确认为JDK1.8版本。如果未安装JDK,请从官方网站下载安装包并安装。

  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