openGauss应用开发指南（7）

基于JDBC开发

JDBC（Java Database Connectivity，Java数据库连接）是一种用于执行SQL语句的Java API，可以为多种关系数据库提供统一访问接口，应用程序可基于它操作数据。openGauss库提供了对JDBC 4.0特性的支持，需要使用JDK1.8版本编译程序代码，不支持JDBC桥接ODBC方式。

• JDBC包、驱动类和环境类
• 开发流程
• 加载驱动
• 连接数据库
• 连接数据库（以SSL方式）
• 连接数据库（以TLCP方式）
• 连接数据库（以UDS方式）
• 执行SQL语句
• 处理结果集
• 关闭连接
• 日志管理
• 示例：常用操作
• 示例：重新执行应用SQL
• 示例：通过本地文件导入导出数据
• 示例：从MY向openGauss进行数据迁移
• 示例：逻辑复制代码示例
• 示例：不同场景下连接数据库参数配置
• 示例：jdbc主备集群负载均衡
• JDBC接口参考
• JDBC常用参数参考

 

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的应用程序可以直接移植到当前系统使用。

驱动类

 说明：

• openGauss在JDBC的使用上与PG的使用方法保持兼容。在同一个JVM虚拟机里加载PostgreSQL和openGauss的JDBC同名驱动时，可能存在org.postgresql.Driver驱动类冲突问题。

• 相比于PG驱动，openGauss JDBC驱动主要做了以下特性的增强：

• 支持SHA256加密方式登录。

• 支持对接实现sf4j接口的第三方日志框架。

• 支持容灾切换。

环境类

客户端需配置JDK1.8，配置方法如下：

1. DOS窗口输入“java -version”，查看JDK版本，确认为JDK1.8版本。如果未安装JDK，请从官方网站下载安装包并安装。

2. 根据如下步骤配置系统环境变量。

   a. 右键单击“我的电脑”，选择“属性”。

   b. 在“系统”页面左侧导航栏单击“高级系统设置”。

   c. 在“系统属性”页面，“高级”页签上单击“环境变量”。

   d. 在“环境变量”页面上，“系统变量”区域单击“新建”或“编辑”配置系统变量。变量说明请参见表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;”