[设计器]JDBC连接数据库

1.1 版本

1.2 功能简介

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

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

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

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

2.1 进入数据连接设置页面

1）点击「服务器>定义数据连接」进入数据连接配置界面。如下图所示：

2）大部分数据库使用的的是 JDBC 连接，添加 JDBC 连接，如下图所示：

2.2 选择要连接的数据库

1）我们将常用的数据库放置在下拉列表中，若要连接的数据库不在下拉列表中，则可以选择「others」。

在设计器中我们可以连接帆软官方支持的所有数据库。如下图所示：

2）搜索帮助文档，找到自己要连接的对应数据库的文档。比如说我需要连接 apache impala 数据库，对应的帮助文档为 Apache Impala数据连接。

在数据库对应的帮助文档中，我们可以查看到数据库支持的版本，以及要使用的驱动是否已内置等。

2.3 设置驱动器

产品已内置了部分数据库的驱动器，内置的驱动可直接使用。

若产品内没有内置相关驱动，可以通过 驱动管理 上传对应的数据库驱动。然后选择自定义，选择刚刚上传的驱动。例如：选择已上传的 apache impala 数据库的驱动。如下图所示：

2.4 设置 URL 

URL 中一般包含数据库的各种信息，例如：IP名、端口、数据库名等。在平台中连接数据库时，系统可以根据连接信息，自动生成数据连接的 URL 。

用户可参考平台中生成 URL 的格式修改自己的 URL，也可在平台中输入相关信息后直接复制对应 URL。例如：Apache Impala数据连接 生成的 URL 如下图所示：

将生成的 URL 复制到设计器中，若有用户名认证还需输入用户名和密码，点击「测试连接」，如下图所示：

连接成功后效果如下图所示，点击「确定」完成数据连接设置。

2.5 其他设置

设计器中的其他设置同在数据管理平台中一致。

• 使用 SSH 通道可参见：［平台］数据连接管理 4.3 节

• 高级设置可参见：［平台］数据连接管理 4.2 节

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)))

详情请参见：数据集