JDBC包、驱动类和环境类
JDBC包
获取驱动包,包名为GaussDB-Kernel-VxxxRxxxCxx-操作系统版本号-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”(对应包gsjdbc4.jar)。
![](https://support.huaweicloud.com/distributed-devg-v2-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
- 由于GaussDB在JDBC的使用上与PG的使用方法保持兼容,所以同时在同一进程内使用两个JDBC的驱动的时候,可能会类名冲突。
- 本版本JDBC不再支持IAM认证功能。
- 相比于PG驱动,GaussDB JDBC驱动主要做了以下特性的增强:
- 支持SHA256加密方式登录。
- 支持对接实现sf4j接口的第三方日志框架。
- 支持连接级别的分布式负载均衡。
- 支持容灾切换。
环境类
客户端需配置JDK1.8。JDK是跨平台的,支持Windows,Linux等多种平台,下面以Windows为例,介绍JDK配置流程:
- 在Windows下的命令提示符中,输入“java -version”,查看JDK版本,确认为JDK1.8版本。如果未安装JDK,请下载安装包并安装。
- 在Windows操作系统桌面中“此电脑”图标上单击右键,选择“属性”。
- 在弹出的“系统”窗口中,单击左侧导航栏中“高级系统设置”。
- 在弹出的“系统属性”窗口中,单击右下角的“环境变量”。
- 在弹出的“环境变量”窗口中的“系统变量”区域框中设置如下变量名和变量值。
变量名
操作
变量值
JAVA_HOME
- 若存在,则单击“编辑”。
- 若不存在,则单击“新建”。
JAVA的安装目录。
例如:C:\Program Files\Java\jdk1.8.0_131
Path
编辑
CLASSPATH
新建
.;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar;
- 单击“确定”,并依次关闭各窗口。