更新时间:2023-10-23 GMT+08:00

JDBC包、驱动类和环境类

JDBC包

单击此处获取GaussDB提供的发布包。

从发布包中获取。包名为GaussDB-Kernel_VxxxRxxxCxx.x-操作系统版本号-64bit-Jdbc.tar.gz。解压后JDBC的驱动jar包:
  • gsjdbc4.jar:驱动类名和加载路径与PostgreSql相同,方便运行于PostgreSQL上的业务进行迁移,但接口的支持情况并不与PostgreSQL完全一致,部分不支持接口需要业务侧进行调整。
  • gsjdbc200.jar:驱动类名和加载路径与Gauss200相同,方便运行于Gauss200上的业务进行迁移,但接口支持情况并不与Gauss200完全相同,部分不支持接口需要业务侧调整。
  • opengaussjdbc.jar:主类名为“com.huawei.opengauss.jdbc.Driver”,数据库连接的url前缀为“jdbc:opengauss”,推荐使用此驱动包。如果遇到同一JVM进程内需要同时访问PostgreSQL及GaussDB的场景,请使用此驱动包。
    • 各驱动包只是驱动类加载路径不同,接口功能上相同。
    • 不能使用gsjdbc4的驱动包操作PostgreSQL数据库,虽然部分版本能够建连成功,但部分接口行为与PostgreSQL JDBC不同,可能导致未知错误。
    • 不能使用PostgreSQL的驱动包操作GaussDB数据库,虽然部分版本能够建连成功,但部分接口行为与GaussDB JDBC不同,可能导致未知错误。

驱动类

在创建数据库连接之前,需要加载数据库驱动类“org.postgresql.Driver”。

  1. 由于GaussDB在JDBC的使用上与PG的使用方法保持兼容,所以同时在同一进程内使用两个JDBC驱动的时候,可能会类名冲突。
  2. 相比于PG驱动,GaussDB JDBC驱动主要做了以下特性的增强:
    1. 支持SHA256加密方式登录。
    2. 支持对接实现sf4j接口的第三方日志框架。
    3. 支持容灾切换。

环境类

客户端需配置JDK1.8,配置方法如下:

  1. DOS窗口输入“java -version”,查看JDK版本,确认为JDK1.8版本。如果未安装JDK,请从官方网站下载安装包并安装。
  2. 根据如下步骤配置系统环境变量。

    1. 右键单击“我的电脑”,选择“属性”
    2. “系统”页面左侧导航栏单击“高级系统设置”
    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;