更新时间:2024-05-07 GMT+08:00

JDBC包、驱动类和环境类

JDBC包

从发布包中获取。包名为GaussDB-Kernel_数据库版本号_操作系统版本号_64bit_Jdbc.tar.gz。

解压后JDBC的驱动jar包:

  • gsjdbc4.jar:主类名为“org.postgresql.Driver”,数据库连接的url前缀为“jdbc:postgresql”,该驱动包适用于从PostgreSQL迁移业务的场景,驱动类和加载路径与迁移前保持一致,但接口支持情况不完全一致,未支持的接口需要业务侧进行调整。
  • gscejdbc.jar:主类名为“com.huawei.gaussdb.jdbc.Driver”,数据库连接的url前缀为“jdbc:gaussdb”,此驱动包打包了密态数据库需要加载的加解密相关的依赖库,密态场景推荐使用此驱动包,目前仅支持EulerOS操作系统。使用gscejdbc.jar驱动包时,需要先设置环境变量LD_LIBRARY_PATH。具体使用方式详见《特性指南》中“设置密态等值查询 > 使用JDBC操作密态数据库”章节。
  • opengaussjdbc.jar:主类名为“com.huawei.opengauss.jdbc.Driver”,数据库连接的url前缀为“jdbc:opengauss”,推荐使用此驱动包。如果遇到同一JVM进程内需要同时访问PostgreSQL及GaussDB的场景,请使用此驱动包。
  • 各驱动包只是驱动类加载路径和url前缀不同,接口功能上相同。
  • gsjdbc200.jar:主类名为“com.huawei.gauss200.jdbc.Driver”,数据库连接的url前缀为“jdbc:gaussdb”,该驱动包适用于从Gauss200迁移业务的场景,驱动类和加载路径与迁移前保持一致,但接口支持情况不完全一致,未支持的接口需要业务侧进行调整。
  • 不能使用gsjdbc4的驱动包操作PostgreSQL数据库,虽然部分版本能够建连成功,但部分接口行为与PostgreSQL JDBC不同,可能导致未知错误。
  • 不能使用PostgreSQL的驱动包操作GaussDB数据库,虽然部分版本能够建连成功,但部分接口行为与GaussDB JDBC不同,可能导致未知错误。

驱动类

在创建数据库连接之前,需要加载数据库驱动类“org.postgresql.Driver”(对应包gsjdbc4.jar)。

  1. 由于GaussDB在JDBC的使用上与PG的使用方法保持兼容,所以同时在同一进程内使用两个JDBC的驱动的时候,可能会造成类名冲突。
  2. 本版本JDBC不再支持IAM认证功能。
  3. 相比于PG驱动,GaussDB JDBC驱动主要做了以下特性的增强:
    1. 支持SHA256加密方式登录。
    2. 支持对接实现sf4j接口的第三方日志框架。
    3. 支持连接级别的分布式负载均衡。
    4. 支持容灾切换。

环境类

客户端需配置JDK1.8。JDK是跨平台的,支持Windows,Linux等多种平台,下面以Windows为例,介绍JDK配置流程:

  1. DOS窗口(windows下的命令提示符)输入“java -version”,查看JDK版本,确认为JDK1.8版本。如果未安装JDK,请下载安装包并安装。
  2. 在windows操作系统桌面中“此电脑”图标上单击右键,选择“属性”。
  3. 在弹出的“系统”窗口中,单击左侧导航栏中“高级系统设置”。
  4. 在弹出的“系统属性”窗口中,单击右下角的“环境变量”。
  5. 在弹出的“环境变量”窗口中的“系统变量”区域框中设置如下变量名和变量值。

    表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。

  6. 单击“确定”,并依次关闭各窗口。