JDBC包、驱动类和环境类

JDBC包

openGauss提供两种JDBCjar包:postgresql.jar和openGauss-jdbc-x.x.x.jar,两种jar包功能一致,仅仅是为了解决和PostgreSQL之间的JDBC驱动包名冲突。

在Linux服务器端源代码目录下执行build.sh,获得驱动jar包postgresql.jar和opengauss-jdbc-x.x.x.jar,包位置在源代码内output目录下。也可以从官网发布包中获取,包名为openGauss-x.x.x-JDBC.tar.gz。

驱动包与PostgreSQL保持兼容,其中类名、类结构与PostgreSQL驱动完全一致,曾经运行于PostgreSQL的应用程序可以直接移植到当前系统使用。

驱动类

JDBC包、驱动类和环境类 - 图1 说明:

  1. openGauss在JDBC的使用上与PG的使用方法保持兼容。在同一个JVM虚拟机里加载PostgreSQL和openGauss的JDBC同名驱动时,可能存在org.postgresql.Driver驱动类冲突问题。
  2. 相比于PG驱动,openGauss JDBC驱动主要做了以下特性的增强:
  3. 支持SHA256加密方式登录。
  4. 支持对接实现sf4j接口的第三方日志框架。
  5. 支持容灾切换。

环境类

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