1. 概述
1.1 版本
报表服务器版本 | 功能变动 |
---|---|
11.0 | - |
11.0.4 | 详见:4.3节、4.4节 设计器 JDBC 数据连接新增 SSH 设置,提升安全性 设计器 Mysql 数据连接新增 SSL 设置,提升安全性 |
11.0.10 | 新增「数据连接超时检测」功能 |
1.2 功能简介
通过平台里的「数据连接」选项,可以不需要设计器,直接新建数据连接。还可以查看当前报表连接了哪些数据库,并且进行修改。
平台创建的数据连接在设计器里也可以进行管理,详细点击 [设计器] JDBC 连接数据库 。
2. 创建数据连接
以管理员身份进入数据决策系统,点击「管理系统>数据连接>数据连接管理>新建数据连接」可创建新的数据连接,如下图所示:
注:如果非管理员用户想要配置数据连接,需要管理员给其分配管理系统下数据连接节点的权限,具体操作请查看 数据连接控制
3. 选择数据库类型
单击「新建数据连接」按钮,有三种类型选择,分别为常用,所有,其他。如下图所示:
常用:显示常用的几个数据库类型
所有:展示平台支持的所有数据库类型
其他:新建数据连接包括 JDBC 数据连接和 JNDI 数据连接(详情请参见:JNDI数据连接),和已适配的第三方数据源插件。
4. 连接数据库
4.1 配置数据库信息
选择一个数据库,进入数据的连接配置页面,如下图所示:
具体的连接方式请参照对应文档,例如此处选的是 apache impala 数据库,连接步骤可参见:Apache Impala数据连接
以下介绍所有配置项的含义:
配置 | 介绍 |
---|---|
数据连接名称 | 给这个数据连接一个名称,按用户自己的习惯起名即可 |
驱动 | 连接数据库所需要的驱动:
|
数据库名称 | 输入要连接的数据库的名字 |
主机 | 输入数据库所在主机(或服务器)的 IP |
端口 | 输入数据库所在主机(或服务器)的端口 |
认证方式 | 若数据库支持多种认证方式,则点击会出现认证方式下拉框:
|
编码 | 推荐使用自动 |
模式 |
|
4.2 连接池设置
在连接数据库时,我们可以根据自己的需求进行一些高级设置,也可以不设置,详细请参见:数据连接高级设置
4.3 SSH设置
若用户安全性要求高,需要使用 SSH 。可以直接勾选「使用SSH通道」,输入对应信息。
注:验证方法支持密码和公钥,其中选择「公钥」需要将文件放置在 %FineReport%/webapps/webroot/WEB-INF/resources 下。
4.4 SSL设置
注:暂只支持 MySQL 数据库
1)在%FineReport%/webapps/webroot/WEB-INF/resources/certificates 中放入 CA 证书、客户端证书以及客户端秘钥,并添加至数据连接中,如下图所示:
2)勾选「使用SSL通道」,将文件添加进对应位置
3)点击「测试连接」,如下图所示:
5. 管理数据连接
5.1 管理范围
在数据决策系统中,点击「管理系统>数据连接>数据连接管理」,可对数据连接进行管理,如下图所示:
点击某一数据连接右侧图标后,出现的按钮介绍如下表所示:
按钮名称 | 说明 |
---|---|
测试连接 | 测试数据库配置是否成功 |
编辑 | 点击「编辑」按钮后,可修改数据连接的各配置项 |
重命名 | 重命名该数据连接 |
复制 | 复制该数据库,且数据连接名自动加 1 |
删除 | 删除该数据库 |
类型、创建者 | 显示数据库类型和创建者 |
平台未适配的数据连接,例如未适配的第三方数据源插件,平台中只能读取到数据源的名字,无法新建、编辑及查看具体的设置,只能在设计器中进行新建、编辑和查看。提示「该类型暂仅支持在设计器中使用旧版本数据连接查看」,如下图所示:
5.2 连接池状态
注:只有 JDBC 类型的数据库有连接池。
数据连接界面提供连接池状态页面,可看到目前已创建的数据连接及对应的连接状态,如下图所示:
「活动连接数」和「空闲连接数」的说明如下表所示:
连接池状态 | 说明 |
---|---|
活动连接数 | 连接池最大可创建的连接数,若最大连接数是 10 ,程序已申请 10 个连接,而且一直在使用,第 11 个连接申请时报错:active 10 maxActive 10 |
空闲连接数 | 当前处于空闲状态的连接, 随时会转成活动连接, 空闲状态超过最大空闲连接时间时自动释放 活动连接数+空闲连接数=实际物理连接数 |
5.3 数据连接超时检测
在「数据连接管理>全局设置」中,提供「数据连接超时检测」功能,支持用户自定义数据连接的超时时间。
数据连接超时时,报错「31300010 kdc服务器不连通」,可手动调大超时时间。