历史版本34 :［平台］数据连接管理 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 版本

报表服务器版本
功能变动
11.0
-
11.0.4

详见：4.3节、4.4节

设计器 JDBC 数据连接新增 SSH 设置，提升安全性

设计器 Mysql 数据连接新增 SSL 设置，提升安全性

11.0.10新增「数据连接超时检测」功能

1.2 功能简介

通过平台里的「数据连接」选项，可以不需要设计器，直接新建数据连接。还可以查看当前报表连接了哪些数据库，并且进行修改。

平台创建的数据连接在设计器里也可以进行管理，详细点击 [设计器] JDBC 连接数据库 。

2. 创建数据连接编辑

以管理员身份进入数据决策系统，点击「管理系统>数据连接>数据连接管理>新建数据连接」可创建新的数据连接，如下图所示：

注：如果非管理员用户想要配置数据连接，需要管理员给其分配管理系统下数据连接节点的权限，具体操作请查看 数据连接控制

1.png

3. 选择数据库类型编辑

单击「新建数据连接」按钮，有三种类型选择，分别为常用，所有，其他。如下图所示：

2.png

  • 常用：显示常用的几个数据库类型

  • 所有：展示平台支持的所有数据库类型

  • 其他：新建数据连接包括 JDBC 数据连接和 JNDI 数据连接（详情请参见：JNDI数据连接），和已适配的第三方数据源插件。

4. 连接数据库编辑

4.1 配置数据库信息

选择一个数据库，进入数据的连接配置页面，如下图所示：

33.png

具体的连接方式请参照对应文档，例如此处选的是 apache impala 数据库，连接步骤可参见：Apache Impala数据连接

以下介绍所有配置项的含义：

配置
介绍
数据连接名称给这个数据连接一个名称，按用户自己的习惯起名即可
驱动

连接数据库所需要的驱动：

  • 默认：一小部分数据库中内置了数据库驱动，使用默认即可。

  • 自定义：FineReport 中未内置驱动，需要用户自定义驱动，详细操作请参见：驱动管理

数据库名称输入要连接的数据库的名字
主机输入数据库所在主机（或服务器）的 IP
端口输入数据库所在主机（或服务器）的端口
认证方式

若数据库支持多种认证方式，则点击会出现认证方式下拉框：

  • 用户名密码：输入数据库的用户名和密码

  • Kerberos认证：填入注册过 kdc 的客户端名称和 keytab 密钥路径，详情请参见[平台]数据连接 Kerberos 认证

编码推荐使用自动
模式

  • 部分数据库需要选择模式，需要先连接成功后才能选择模式

  • 当数据库不存在模式选择，则无需进行模式选择

  • 如果这些数据库未进行模式选择，则默认选择的是第一个模式

  • 连接多模式的数据库时使用 SQL 语句需要带上模式名前缀进行搜索

4.2 连接池设置

在连接数据库时，我们可以根据自己的需求进行一些高级设置，也可以不设置，详细请参见：数据连接高级设置

34.png

4.3 SSH设置

若用户安全性要求高，需要使用 SSH 。可以直接勾选「使用SSH通道」，输入对应信息。

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

35.png

4.4 SSL设置

注：暂只支持 MySQL 数据库

1）在%FineReport%/webapps/webroot/WEB-INF/resources/certificates 中放入 CA 证书、客户端证书以及客户端秘钥，并添加至数据连接中，如下图所示：

36.png

2）勾选「使用SSL通道」，将文件添加进对应位置

38.png

3）点击「测试连接」，如下图所示：

39.png

5. 管理数据连接编辑

5.1 管理范围

在数据决策系统中，点击「管理系统>数据连接>数据连接管理」，可对数据连接进行管理，如下图所示：

4.png

点击某一数据连接右侧图标后，出现的按钮介绍如下表所示：

按钮名称说明
测试连接测试数据库配置是否成功
编辑

点击「编辑」按钮后，可修改数据连接的各配置项

重命名重命名该数据连接
复制复制该数据库，且数据连接名自动加 1
删除删除该数据库
类型、创建者
显示数据库类型和创建者

平台未适配的数据连接，例如未适配的第三方数据源插件，平台中只能读取到数据源的名字，无法新建、编辑及查看具体的设置，只能在设计器中进行新建、编辑和查看。提示「该类型暂仅支持在设计器中使用旧版本数据连接查看」，如下图所示：

5.2 连接池状态

注：只有 JDBC 类型的数据库有连接池。

数据连接界面提供连接池状态页面，可看到目前已创建的数据连接及对应的连接状态，如下图所示：

5.png

「活动连接数」和「空闲连接数」的说明如下表所示：

连接池状态说明
活动连接数

连接池最大可创建的连接数，若最大连接数是 10 ，程序已申请 10 个连接，而且一直在使用，第 11 个连接申请时报错：active 10 maxActive 10

空闲连接数

当前处于空闲状态的连接, 随时会转成活动连接, 空闲状态超过最大空闲连接时间时自动释放

活动连接数+空闲连接数=实际物理连接数

5.3 数据连接超时检测

在「数据连接管理>全局设置」中，提供「数据连接超时检测」功能，支持用户自定义超时时间。

数据连接超时时，报错「31300010 kdc服务器不连通」，可手动调大超时时间。