配置数据连接

1.1 版本

1.2 功能简介

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

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

使用拥有 FineBI 数据连接权限的用户账号登录数据决策系统（一般为管理员），点击「管理系统>数据连接>数据连接管理>新建数据连接」可创建新的数据连接，如下图所示：

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

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

2.1 常用

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

2.2 所有

显示 FineBI 内置支持和插件支持的数据库类型，分别为：阿里云AnalyticDB、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，以及安装插件支持的数据库类型，如下图所示：

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

2.3 其他

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

2.3.1 JNDI 数据连接

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

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

2.3.2 其他 JDBC

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

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

不同数据库需配置的信息可能有所不同，下面介绍「模式」和「认证方式」这两个属性的具体信息。

4.1 模式

在连接 Amazon Redshift 、Apache KYLIN、Apache Phoenix、DEBRY、HP Vertica、IBM DB2、INFORMIX、Microsoft SQL Server、Oracle、Pivotal Greenplum Database、Postgresql、GBase 8S、GBase 8T、KINGBASE、Presto、SAP HANA、SAP Sybase、Hbase 这些数据库时，会比其他数据连接多了一步：模式，如下图所示：

模式介绍如下所示：

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

• 有些数据库不需要选择模式，也没有模式选择的按钮，则无需进行模式选择。

• 模式默认不可编辑，点击「点击连接数据库」且连接成功后可编辑。

• 有模式选择的数据库，需要用户的数据库中有可用的模式，否则会报错。
  

需要正确选择数据库对应的模式，否则会导致添加数据库表时显示「当前数据连接中无可用表」，只能通过 SQL 数据集进行取数。

4.2 认证方式

其中 APACHE IMPALA、Hadoop Hive、SPARK  、TRANSWARP INCEPTOR、APACHE Phoenix、HBase 这六个数据库在配置数据连接时有 认证方式这一选项。如下图所示：

具体介绍如下所示：

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

• 若选择「Kerberos」认证，则填入注册过 kdc 的客户端名称和 keytab 密钥路径。

• 详细 Kerberos 认证请参考 数据连接 Kerberos 认证

4.3 高级设置

高级设置界面如下图所示：

其中连接池属性的各参数说明如下表所示：

5.1 管理范围

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

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

需要注意以下几点：

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

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

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

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

5.2 连接池状态

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

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

6.1 数据无法预览

问题描述：

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

原因分析：

数据库表中有重复的字段名，BI 是不支持重复字段名及空值的，如下图所示：

解决方案：

重新修改重复的字段名。