文档首页/ 云数据库 GaussDB/ 开发指南（集中式_V2.0-2.x）/ 应用程序开发教程/ 基于JDBC开发/ 开发步骤/ 获取驱动jar包并配置JDK1.8
更新时间：2025-07-18 GMT+08:00
查看PDF
分享

获取驱动jar包并配置JDK1.8

环境准备包括获取驱动jar包、配置JDK1.8。

获取驱动包

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

表1 驱动包下载列表

版本

下载地址

V2.0-2.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进行校验。

获取驱动jar包

解压获取到的驱动包，找到名为GaussDB-Kernel_数据库版本号_操作系统_64bit_Jdbc.tar.gz的JDBC驱动包并解压，解压后，可获得以下驱动jar包：

  • gsjdbc4.jar：主类名为“org.postgresql.Driver”，数据库连接的url前缀为“jdbc:postgresql”。该驱动包适用于从PostgreSQL迁移业务的场景，驱动类和加载路径与迁移前保持一致，但接口支持情况不完全一致，未支持的接口需要业务侧进行调整。
  • opengaussjdbc.jar：主类名为“com.huawei.opengauss.jdbc.Driver”，数据库连接的url前缀为“jdbc:opengauss”，推荐使用此驱动包。如果遇到同一JVM进程内需要同时访问PostgreSQL及GaussDB的场景，请使用此驱动包。
    • 各驱动包只是驱动类加载路径和url前缀不同，接口功能上相同。
    • gsjdbc200.jar：该驱动包适用于从Gauss200迁移业务的场景，驱动类和加载路径与迁移前保持一致，但接口支持情况不完全一致，未支持的接口需要业务侧进行调整。
    • 不能使用gsjdbc4.jar驱动包操作PostgreSQL数据库，虽然部分版本能够建连成功，但部分接口行为与PostgreSQL JDBC不同，可能导致未知错误。
    • 不能使用PostgreSQL的驱动包操作GaussDB数据库，虽然部分版本能够建连成功，但部分接口行为与GaussDB JDBC不同，可能导致未知错误。

配置JDK1.8

客户端需配置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

父主题： 开发步骤