1.1 版本

1.2 功能简介

使用 FineBI 进行数据分析的第一步即获取数据，获取数据的第一步即定义数据来源。实际用户系统最常见的是将数据保存在数据库中，并且不断更新。无论使用 FineBI Spider 引擎的何种数据类型，都支持对数据的不断更新。

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

注：配置数据连接在线视频学习请查看 数据连接

2.1 创建数据连接

2.1.1 方式一

使用拥有 FineBI 数据连接权限的用户账号登录数据决策系统（一般为管理员），点击管理系统>数据连接>数据连接管理可进入数据连接界面，包含数据连接管理和连接池状态栏。如下图所示：

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

2.1.2 方式二

在数据决策系统左下角直接点击创建>新建数据连接，快速进入数据连接创建页面，如下图所示：

2.2 类型选择

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

2.2.1 常用

固定显示几个常用的数据库类型，分别为 Hsql、IBM DB2、Microsoft SQL Server、MySQL、Oracle。如下图所示：

2.2.2 所有

显示 FineBI 内置支持和插件支持的数据库类型，分别为：ADS、Amazon Redshift、Apache Impala、Apache KYLIN、Apache Phoenix、DERBY、GBase 8A、GBase 8S、GBase 8T、H2、华为云DWS、Fusioninsight elk、Fusioninsight HD、GaussDB 200、Hadoop Hive、HBase、HP Vertica、HSQL、IBM DB2、INFORMIX、KINGBASE、Microsoft SQL Server、MySQL、Oracle、Pivotal Greenplum Database、Postgresql、Presto、SAP HANA、SAP Sybase、SPARK、Sqlite、TeraData、TRANSWARP INCEPTOR，以及安装插件支持的数据库类型，如下图所示：

注1：当前仅支持部分插件类型，未支持类型请使用设计器的旧版本数据连接进行创建。

注2：可通过「内置支持」和「插件支持」的勾选，对数据库类型进行筛选；若都不勾选，则显示空白。

2.2.3 其他

「其他」类型中包括JNDI数据连接和其他JDBC。如下图所示：

2.3 新建数据连接

新建数据连接步骤如下图所示：

2.3.1 JDBC数据连接

1）以「常用」类型下的 IBM DB2 数据库为例，点击常用>IBM DB2，进入数据连接界面，输入数据连接名称、主机、端口号等相关信息，如有需要可进行高级设置，在设置完成后点击测试连接，确认连接成功后点击保存即可。如下图所示：

高级设置详细内容如下图所示：

2）如果数据库列表中没有所需的数据库类型，则选择「其他」类型下的其他JDBC，将对应驱动包放置在%FineBI%\webapps\webroot\WEB-INF\lib下，并重启 FineBI，需要手动输入驱动器名称、URL 等完整数据连接信息，点击测试连接连接成功后，点击保存即可。如下图所示：

以下为数据连接步骤所包含的各个配置项的介绍：

1）填写数据连接信息：

以下为部分数据连接信息的详细解释：

注：Kerberos 认证详情参见 数据连接Kerberos认证 

2）选择填写高级设置：初始化连接数、最大活动连接数、最大空闲连接数、最小空闲连接数、最大等待时间、SQL验证查询、获取连接前校验、归还连接前检验、开启空闲回收器检验、空闲连接回收器休眠时间、空闲连接回收检验数、保持空闲最小时间值。

下表为高级设置配置项的介绍：

3）测试连接：点击测试连接测试数据库配置是否成功，若连接成功则弹出「连接成功」提示框，若连接失败则显示失败详细原因。

4）模式选择：在有些数据库中，存在模式的概念，用来区分数据库对象的不同逻辑结构。FineBI 也提供了这类型数据库的模式选择，在连接时，会比其他数据连接多一步：选择模式。存在选择模式的数据库类型如下表所示：

注1：如果以上数据库未进行模式选择，则默认选择第一个模式；当数据库不存在模式选择，则无需进行模式选择。

注2：模式建立的初衷是为了其他功能更容易读取数据库里的数据，选择「默认值」即可。

注3：模式默认不可编辑，点击点击连接数据库按钮且连接成功后可编辑。

注4：连接多模式的数据库时使用 SQL 语句需要带上「模式名前缀」进行搜索。

2.3.2  JNDI 数据连接

点击新建数据连接按钮，在「其他」类型中选择JNDI数据连接，如下图所示：

注：JNDI 数据连接仅支持 Finereport ，FineBI 暂不支持数据准备处使用。

2.4 管理数据连接

2.4.1 管理范围

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

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

2.4.2 注意事项

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

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

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

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

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