配置数据连接入门

1.1 版本

1.2 功能简介

实际使用时最常见的是将业务数据保存在数据库中，并且不断更新。建立 FineBI 与数据库的连接，让 FineBI 能够直接获取到数据库中的数据。

1.3 注意事项

在进行数据连接时，不支持数据库中表名和字段名包含下表所示的特殊字符：

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

注：如果非管理员，用户需要有 数据连接使用权限 才可以设置数据连接。

接下来我们需要选择自己需要的数据库类型，本文选择「MySQL」数据库。如下图所示：

4.1 配置数据库信息

输入数据库的相关信息，如下图所示：

不同数据库具体的连接方式可能略有不同，可查看具体的文档，例如 MySQL 可查看：MySQL数据连接

以下为数据连接信息的详细解释，不同数据库要设置的连接信息不同，所以某些数据库会缺失一些项。

点击「测试连接」，即可测试是否可以连接成功。

若用户不需要进行一些特殊的配置（本文 4.2、4.3、4.4节），到这里已经可以点击「保存」结束配置了。

4.2 高级设置

在连接数据库时，我们有可能需要进行一些高级设置，但大部分情况下是不需要设置的。我们可以根据需要选择性设置，如下图所示：

• 常用设置

连接数指的是连接到数据库的 IO 活动数。若同时对此数据库进行连接取表的用户数越多，连接数就越高。

连接数高会严重影响数据库的性能，所以我们需要设置最大活动连接数进行限制。

• 更多设置（不常用，如无特殊场景不建议修改）

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.1 管理范围

在数据决策系统中，点击「管理系统>数据连接>数据连接管理」，点击某一数据库右侧图标，如下图所示：

「数据连接管理」各设置项说明如下表所示：

需要注意以下几点：

• 未适配的数据库类型右侧不显示图标。

• 在管理数据连接时，数据连接的名字不能随意改动。更新到本地的表与数据库匹配依靠的是数据连接的名字，如果修改数据连接的名字，从该连接中取出的表将无法再更新。  

  如果是 SQL 数据集，也会导致没有「修改 SQL」的按钮。
  

• 如果更新本地保存的表中的数据库，例如由开发环境变化到生产环境，表名与表结构均一致时，只需要修改数据连接的 URL 即可。本地保存的表依照数据连接名依然可以更新数据。

5.2 连接池状态

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

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

6.1 数据无法预览

BI 连接服务器数据集，数据预览时有报错信息：find fieldinfo failed for table:XXX

这是因为数据库表中有重复的字段名，BI 是不支持重复字段名及空值的，如下图所示。我们需要重新修改重复的字段名。

6.2 无法新增数据连接

用户新增数据连接失败，并报错当前数据连接数量已达到注册lic限制（0个），无法新增，如下图所示：

方案一：关闭 IE 浏览器兼容性视图。

方案二：若要在 IE 浏览器兼容性视图下进行数据决策系统的「管理系统」配置，需要手动调高 IE 内核版本才可以支持使用，操作步骤如下所示：

1）IE 浏览器打开数据决策系统页面，点击页面右上角「工具>F12 开发人员工具」，如下图所示：

2）以 IE10 浏览器为例，手动调高 IE 内核版本。如下图所示：