1. 概述
1.1 版本
| FineBI 版本 | 功能变动 |
| 5.1 | - |
| 5.1.22 | 4.2 高级设置布局优化 |
1.2 功能简介
使用 FineBI 进行数据分析的第一步即获取数据，获取数据的第一步即定义数据来源。实际用户系统最常见的是将数据保存在数据库中，并且不断更新。
1.3 注意事项
在进行数据连接时，不支持数据库中表名和字段名包含下表所示的特殊字符：
| 表名和字段名不支持包含下面字符 | ||||||||
|---|---|---|---|---|---|---|---|---|
| JO | JO_ | __NULL__ | __EMPTY__ | ## | __order | __partition | ##RF# | JO |
| . | [ | ] | {} | ( | ) | = | / | _ |
| RE_ | MT | RE+自然数 | RE | - | MT_ | MT | ||
2. 创建数据连接
3. 选择数据库类型
接下来我们需要选择自己需要的数据库类型，本文选择「MySQL」数据库。如下图所示：
4. 配置数据连接
4.1 配置步骤
1）连接数据库之前，需要将数据库对应的驱动上传至 FineBI（若驱动已内置，则不用上传） ，操作可参见：驱动管理 。
数据库对应的驱动可参见具体的数据库文档，例如 MySQL 可查看：MySQL数据连接 。
2）配置数据库的相关信息
不同数据库具体的连接方式可能略有不同，可查看具体的文档，例如 MySQL 可查看：MySQL数据连接
以下为数据连接信息的详细解释，不同数据库要设置的连接信息不同，所以某些数据库会缺失一些项。
| 配置 | 介绍 |
|---|---|
| 数据连接名称 | 给这个数据连接一个名称，建议按照数据库名字来命名，如：mysql连接、SQL server连接等。 注：数据连接名称后续不可修改，修改后会导致表不可用。 |
| 驱动 | 连接数据库所需要的驱动：
|
| 数据库名称 | 输入要连接的数据库的名字 |
| 主机 | 输入数据库所在主机（或服务器）的 IP |
| 端口 | 输入数据库所在主机（或服务器）的端口 |
| 认证方式 | 若数据库支持多种认证方式，则点击会出现认证方式下拉框：
|
| 编码 | 推荐使用默认 |
| 模式 |
注：需要正确选择数据库对应的模式，否则会导致添加数据库表时显示「当前数据连接中无可用表」，只能通过 SQL 数据集进行取数。 |
| 数据连接URL | 自动生成的 URL ，无需特意配置 |
点击「测试连接」，即可测试是否可以连接成功。
若用户不需要设置连接池，即可点击「保存」。完成数据连接配置。
4.2 连接池设置
在连接数据库时，我们有可能需要进行一些高级设置，但大部分情况下是不需要设置的。我们可以根据需要选择性设置，如下图所示：
常用设置
| 名称 | druid学名 | 默认值 | 含义 |
|---|---|---|---|
| 最大活动连接数 | maxActive | 50 | 连接池在同一时间能够分配的最大活动连接的数量 |
| 校验语句 | validationQuery | 默认语句 | 用来检测连接是否有效的 SQL 语句，要求是一个查询语句，常用select 'x' 。用户可自定义该语句。 |
| 获取连接前检验 | testOnBorrow | 是 | 申请连接时执行 validationQuery 检测连接是否有效 |
| 最大等待时间 | maxWait | 10000 | 获取连接时最大等待时间，单位毫秒 |
更多设置（不常用，如无特殊场景不建议修改）
| 名称 | druid学名 | 默认值 | 含义 |
|---|---|---|---|
| 初始化连接数 | initialSize | 0 | 初始化时建立物理连接的个数 |
| 最小空闲连接数 | minIdle | 0 | 连接池最小连接数量 |
| 归还连接前校验 | testOnReturn | 否 | 归还连接时执行validationQuery检测连接是否有效 |
| 开启空闲回收器校验 | testWhileIdle | 否 | 指明连接是否被空闲连接回收器(如果有)进行检验，如果检测失败，则连接将被从池中去除 |
| 空闲连接回收器休眠时间 | timeBetweenEvictionRunsMillis | -1 | 在空闲连接回收器线程运行期间休眠的时间值，以毫秒为单位 |
| 空闲连接回收检查数 | numTestPerEvictionRun | 3 | 在每次空闲连接回收器线程（如果有）运行时检查的连接数量 |
| 保持空闲最小时间值 | minEvictableIdleTimeMillis | 1800s | 连接保持空闲而不被驱逐的最小时间 |
4.3 SSH 设置
若用户安全性要求高，需要使用 SSH 。可以直接勾选「使用SSH通道」，输入对应信息。
注：验证方法支持密码和公钥，其中选择「公钥」需要将文件放置在 %FineBI%/webapps/webroot/WEB-INF/resources 下。
点击「测试连接」，若提示连接成功，点击「保存」保存该配置。
4.4 SSL 设置
注：暂只支持 MySQL 数据库
1）在%FineBI%/webapps/webroot/WEB-INF/resources/certificates 中放入 CA 证书、客户端证书以及客户端秘钥，如下图所示：
2）勾选「使用SSL通道」，将文件添加进对应位置。如下图所示：
3）点击「测试连接」，若连接成功点击「保存」保存该配置。
5. 管理数据连接
5.1 管理范围
在数据决策系统中，点击「管理系统>数据连接>数据连接管理」，点击某一数据库右侧图标，如下图所示：
「数据连接管理」各设置项说明如下表所示：
| 设置项 | 说明 |
|---|---|
| 测试连接 | 测试数据库配置是否成功 |
| 编辑 | 修改数据连接配置项 |
| 重命名 | 重命名该数据库 |
| 复制 | 复制该条数据库，且数据连接名自动加 1 |
| 删除 | 删除该数据库 |
| 数据连接信息 | 显示数据库类型和创建者 |
需要注意以下几点：
未适配的数据库类型右侧不显示
图标。在管理数据连接时，数据连接的名字不能随意改动。更新到本地的表与数据库匹配依靠的是数据连接的名字，如果修改数据连接的名字，从该连接中取出的表将无法再更新。
如果是 SQL 数据集，也会导致没有「修改 SQL」的按钮。
如果更新本地保存的表中的数据库，例如由开发环境变化到生产环境，表名与表结构均一致时，只需要修改数据连接的 URL 即可。本地保存的表依照数据连接名依然可以更新数据。
5.2 连接池状态
数据连接界面提供连接池状态页面，可看到目前已创建的数据连接及对应的连接状态，如下图所示：
「活动连接数」和「空闲连接数」的说明如下表所示：
| 连接池状态 | 说明 |
|---|---|
| 活动连接数 | 连接池最大可创建的连接数，若最大连接数是 10 ，程序已申请 10 个连接，而且一直在使用，第 11 个连接申请时报错：active 10 maxActive 10 |
| 空闲连接数 | 当前处于空闲状态的连接, 随时会转成活动连接, 空闲状态超过最大空闲连接时间时自动释放 活动连接数+空闲连接数=实际物理连接数 |
6. 常见报错
6.1 数据无法预览
BI 连接服务器数据集，数据预览时有报错信息：find fieldinfo failed for table:XXX
这是因为数据库表中有重复的字段名，BI 是不支持重复字段名及空值的，如下图所示。我们需要重新修改重复的字段名。
6.2 无法新增数据连接
用户新增数据连接失败，并报错当前数据连接数量已达到注册lic限制（0个），无法新增，如下图所示：
方案一：关闭 IE 浏览器兼容性视图。
方案二：若要在 IE 浏览器兼容性视图下进行数据决策系统的「管理系统」配置，需要手动调高 IE 内核版本才可以支持使用，操作步骤如下所示：
1）IE 浏览器打开数据决策系统页面，点击页面右上角「工具>F12 开发人员工具」，如下图所示：
2）以 IE10 浏览器为例，手动调高 IE 内核版本。如下图所示：
