什么是openGauss-connector-JDBC

openGauss是一款开源的关系型数据库管理系统，它具有多核高性能、全链路安全性、智能运维等企业级特性。openGauss内核早期源自开源数据库PostgreSQL，融合了华为在数据库领域多年的内核经验，在架构、事务、存储引擎、优化器及ARM架构上进行了适配与优化。作为一个开源数据库，期望与广泛的开发者共同构建一个多元化技术的开源数据库社区。

Java数据库连接，（Java Database Connectivity，简称JDBC）是Java语言中用来规范客户端程序如何来访问数据库的应用程序接口，提供了诸如查询和更新数据库中数据的方法。openGauss-connector-JDBC就是提供给用户通过Java语言访问数据库的应用程序接口。用户可以使用openGauss官网提供的jar包，也可以自行构建jar包以使用JDBC操作数据库。

直接获取

在使用openGauss JDBC 驱动之前，请确保您的服务器已经可以正常运行 openGauss 数据库

从maven中央仓库获取

Java开发者可从maven中央仓库中直接获取jar包，坐标如下：

<groupId>org.opengauss</groupId>
<artifactId>opengauss-jdbc</artifactId>

从社区官网下载安装包

1.在官网下载安装包。

登录openGauss.org，在openGauss Connectors部分下，根据您部署数据库的服务器的对应系统选择JDBC_version的下载按钮。version的下载按钮。{version}即您需要的版本号。

2.解压压缩包。

tar -zxvf openGauss-${version}-JDBC.tar.gz

3. 解压后可以看到同级目录下出现了两个jar包，分别是opengauss-jdbc-version.jar和postgresql.jar。opengauss−jdbc−version.jar和postgresql.jar。opengauss−jdbc−{version}.jar是可以与PG-JDBC共存的包, 包名自2.0.1之后的版本全部从org.postgresql变更为org.opengauss,并且驱动名称从jdbc:postgresql://替换为jdbc:opengauss://。目前从maven中央仓库中获取的也是这个包。

从源码构建

概述

openGauss JDBC 驱动目前提供3种构建方式。一是通过一键式脚本build.sh进行构建。二是通过脚本进行逐步构建。三是通过mvn命令进行构建。

操作系统和软件依赖要求

openGauss JDBC 驱动的生成支持以下操作系统：

• CentOS 7.6（x86架构）

• openEuler-20.03-LTS（aarch64架构）

• Windows

以下表格列举了编译openGauss的软件要求。

建议使用从列出的操作系统安装盘或安装源中获取的以下依赖软件的默认安装包进行安装。如果不存在以下软件，请参考推荐的软件版本。

软件及环境依赖要求如下：

下载openGauss-connector-jdbc源码

可以从开源社区下载openGauss-connector-jdbc源码。

git clone https://gitee.com/opengauss/openGauss-connector-jdbc.git

现在我们已经拥有完整的openGauss-connector-jdbc代码，把它存储在以下目录中（以sda为例）。

• /sda/openGauss-connector-jdbc

jar包生成

使用一键式脚本生成jar包（Linux/windows）

openGauss-connector-jdbc中的build.sh是编译过程中的重要脚本工具。该工具可快速进行代码编译和打包。

只需使用如下格式的命令即可编译openGauss-connector-jdbc。

1.执行如下命令进入到代码目录：

[user@linux sda]$ cd /sda/openGauss-connector-jdbc/

2.执行如下命令使用build.sh进行打包：

[user@linux openGauss-connector-jdbc]$ sh build.sh

结束后会显示如下内容，表示打包成功：

Successfully make postgresql.jar
Successfully make opengauss-jdbc-${version} jar package
packaging jdbc...
Successfully make jdbc jar package in openGauss-${version}-${platform}-${bit}-Jdbc.tar.gz
clean up temporary directory!
now, all packages has finished!

复制

成功编译后会出现两个jar包，分别是opengauss-jdbc-${version}.jar与postgresql.jar。编译后的jar包路径为：

/sda/openGauss-connector-jdbc/output。

使用mvn命令生成jar包（Windows 或 Linux）

1.准备 Java 与 Maven环境。

2.执行如下命令进入到代码目录：

[user@linux sda]$ cd /sda/openGauss-connector-jdbc

复制

3.执行mvn命令：

[user@linux openGauss-connector-jdbc]$ mvn clean install -Dgpg.skip -Dmaven.test.skip=true

Linux系统下构建成功后会显示如下结果：

[INFO] Reactor Summary:
[INFO] 
[INFO] openGauss JDBC Driver ............................. SUCCESS [5.344s]
[INFO] PostgreSQL JDBC Driver aggregate .................. SUCCESS [0.004s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 5.439s
[INFO] Finished at: Tue Aug 31 21:55:01 EDT 2021
[INFO] Final Memory: 44M/1763M
[INFO] ------------------------------------------------------------------------

构建成功后会出现两个jar包，分别是opengauss-jdbc-version.jar与original−opengauss−jdbc−version.jar与original−opengauss−jdbc−{version}.jar。jar包路径为/sda/openGauss-connector-jdbc/pgjdbc/target/。 

注意:默认的mvn编译出的jdbc包名为org.postgresql,它与maven中央仓库的包名org.opengauss不同,想打包此包名，请参考build.sh脚本

参考：

https://opengauss.org/zh/docs/latest/docs/Developerguide/%E5%9F%BA%E4%BA%8EJDBC%E5%BC%80%E5%8F%91.html