[设计器]JDBC连接数据库

1.1 版本

1.2 功能简介

FineReport 提供了两种数据连接方式：

方式一：在数据决策系统中进行连接，可参考 配置数据连接

方式二：在设计器中进行连接 ，本文主要介绍该种方法。

注：FineReport 设计器中 JNDI 数据连接步骤请参考 [设计器]JNDI连接数据库

2.1 数据库类型在下拉框中

本章以 MySQL 数据库为例介绍 JDBC 数据连接的步骤。

1）在 FineReport 设计器中点击「服务器>定义数据连接」，点击左上角的「 」按钮，新建数据库，选择「JDBC」方式连接，如下图所示：

2）下拉选择数据库类型为「MySQL」，会自动加载「驱动器」及默认的「URL」等，如下图所示：

3）根据实际数据库地址信息填入「主机」、「端口」、「数据库名称」，会自动生成对应的 URL 。输入 URL 也会自动填入上面的信息。并记得填写「用户名」和「密码」，如下图所示：

各配置项说明如下表所示：

4） 若对安全性要求较高，可设置 SSH。

勾选 「使用 SSH 通道」后，输入下列信息，如下图所示：

注：验证方法支持密码和公钥，其中选择「公钥」需要将文件放置在 %FineReport%/webapps/webroot/WEB-INF/resources 下。

 Mysql 还支持进行 SSL 设置，勾选 「使用 SSL 通道」，在%FineReport%/webapps/webroot/WEB-INF/resources/certificates 中放入 CA 证书、客户端证书以及客户端秘钥，并添加至数据连接中，如下图所示：

5）点击左上方的测试连接，弹出「连接成功」窗口， Mysql 数据库连接成功，点击「确定」。如下图所示：

注：测试连接成功并不是说已经可以正确地获取到数据库的数据，测试的只是网络连接。

2.2 数据库类型不在下拉框中

若需要连接的数据库不在下拉框中，则可选择others，本章以 Apache Impala 数据连接为例。

1）下载驱动文件，参考 配置信息

2）在 FineReport 设计器中点击服务器>定义数据连接，点击左上角的 按钮，新建数据库，选择JDBC方式连接，如下图所示：

3）选择数据库类型为Others，如下图所示：

4）填写对应的 驱动器和 URL （设计器中支持的数据库及对应的连接属性值），同时可以使用 SSH 通道，如下图所示：

注1：示例所连接的数据库没有用户名和密码，所以不用填写用户名和密码。

注2：各配置项说明可参见本文 2.1 章节第三步骤下方表格说明。

5）点击左上方的测试连接，弹出连接成功窗口，Apache Impala 数据库连接成功，点击确定。如下图所示：

Oracle 集群数据库连接：

如果使用的是做过集群的 Oracle 数据库，那在配置数据连接的时候，URL 需要按照以下格式进行填写：

jdbc:oracle:thin:@(description=(address_list= (address=(host=192.168.10.1) (protocol=tcp)(port=1521))(address=(host=192.168.10.2)(protocol=tcp) (port=1521))(load_balance=yes)(failover=yes))(connect_data=(service_name= orcl)))