1. 概述编辑
1.1 版本
FineBI 版本 | JAR 包时间 |
5.1 | 2020-1-15 |
1.2 功能简介
使用 FineBI 进行数据分析的第一步即获取数据,获取数据的第一步即定义数据来源。
实际用户系统最常见的是将数据保存在数据库中,并且不断更新,无论使用 FineBI Spider 引擎的何种数据类型,都支持对数据的不断更新。
本章介绍如何配置数据连接。
配置数据连接在线视频学习请查看【数据连接】
注:在进行数据连接时,请确认需要连接的数据库中数据表的表名和字段名不包含如下特殊字符和字母数字组合:
JO | JO_ | __NULL__ | __EMPTY__ | ## | __order | __partition | ##RF# | JO | RE_ | MT | RE+自然数 | RE |
. | [ | ] | {} | ( | ) | = | / | _ | - | MT_ | MT |
2. 数据连接管理编辑
2.1 创建数据连接方式
2.1.1 方式一
使用拥有 FineBI 数据连接权限的用户账号登录数据决策系统(默认为http://localhost:37799/webroot/decision),一般为管理员,点击管理系统>数据连接<数据连接管理可进入数据连接界面,包含「数据连接管理」和「连接池状态栏」。数据连接管理页面包含已存在的数据连接和新建数据连接按钮,如下图所示:
注:如果非管理员用户想要配置 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)填写数据连接信息:数据连接名称、驱动、数据库名称、主机、端口、用户名、密码、编码(推荐直接选自动即可,2019-1-7及以后的FineBI版本开始支持)、认证方式、模式、数据连接URL。
注:Kerberos 认证详情参见:数据连接Kerberos认证 。
2)选择填写高级设置:初始化连接数、最大活动连接数、最大空闲连接数、最小空闲连接数、最大等待时间、SQL验证查询、获取连接前校验、归还连接前检验、开启空闲回收器检验、空闲连接回收器休眠时间、空闲连接回收检验数、保持空闲最小时间值。
以下为部分连接信息的详细解释:
连接信息 | 说明 |
---|---|
数据连接名称 | 新建数据的名称,用于系统中区分不同数据库的连接 |
驱动 | 用于数据连接的驱动程序,根据自身数据库类型,填入对应连接页面提供的信息 |
URL | 数据连接的 URL 包含数据库名称、IP 、端口等信息,对应数据连接页面提供了 URL 示例,根据自身数据库的信息修改填入即可。 比如 MySQL 的 URL 为:jdbc:mysql://ip:port/dbname,自身数据库 IP 为120.27.40.246,端口为 3306,数据库名称为 mysql,则填入的 URL 为 jdbc:mysql://120.27.40.246:3306/mysql |
编码 | 推荐直接选自动即可(默认即为自动) |
用户名 | 对应连接目的数据库的用户名 |
密码 | 对应连接目的数据库的密码 |
SQL 验证查询 | 发送给目的数据库的校验 SQL 语句 |
获取连接前校验 | 可选择,选定后系统即在获取连接前向对应数据库发送 SQL 校验语句,如果不能成功连接,则去掉这个连接。注:对于连接出现的时断时续现象,可选择「获取连接前校验」并在「 SQL 验证查询」填写校验语句,检查数据连接是否可用。校验 SQL 语句不需要涉及对应数据库中的表,比如可填写 select 1。 |
最大活动连接数 | 系统连接池中最大能容纳的数据连接数量 |
3)测试连接:点击测试连接测试数据库配置是否成功,若连接成功则弹出「连接成功」提示框,若连接失败则显示失败详细原因。
4)模式选择:在有些数据库中,存在模式的概念,用来区分数据库对象的不同逻辑结构。FineBI 也提供了这类型数据库的模式选择,在连接时,会比其他数据连接多一步:选择模式。存在选择模式的数据库类型如下表所示:
APACHE KYLIN | DERBY | HP Vertica | IBM DB2 | INFORMIX | SQL Server | Oracle | Pivotal Greenplum Database | Postgresql |
Amazon Redshift | Apache Phoenix | Gbase 8S | Gbase 8T | KINGBASE | Presto | SAP HANA | SAP Sybase | Hbase |
注:如果以上数据库未进行模式选择,则默认选择第一个模式。
数据连接界面如下图所示:
注1:当数据库不存在模式选择,则无需进行模式选择。
注2:模式默认不可编辑,点击连接数据库且连接成功后可编辑。
2.3.2 JNDI 数据连接
点击新建数据连接按钮,在「其他」类型中选择JNDI数据连接,如下图所示:
注:JNDI 数据连接仅支持 Finereport ,FineBI 暂不支持数据准备处使用。
2.4 管理数据连接
2.4.1 管理范围
创建完成后的已存在数据连接列表中可对数据连接进行一些管理操作,包括:「测试连接」 、「编辑」、「重命名」、「复制」、「删除」、「类型&创建者」。如下图所示:
1)测试连接:测试数据库配置是否成功。
2)编辑:修改各配置项。
单击已有的数据连接,打开数据连接配置信息,可直接在文本框中进行编辑。同时也可直接点击界面右侧编辑按钮修改配置,如下图:
3)重命名:重命名该数据库。
4)复制:复制该条数据库,且数据连接名自动加 1 。
5)删除:删除该数据库。
6)数据连接信息:显示数据库类型和创建者。
2.4.2 注意事项
1)未适配的数据库类型右侧不显示图标。
2)在管理数据连接时,数据连接的名字不能改动。更新到本地的表与数据库匹配依靠的是数据连接的名字,如果修改数据连接的名字,从该连接中取出的表将无法再更新。
3)如果更新本地保存的表中的数据库,例如由开发环境变化到生产环境,表名与表结构均一致时,只需要修改数据连接的 URL 即可。本地保存的表依照数据连接名依然可以更新数据。
3. 连接池状态编辑
数据连接界面还提供了连接池状态页面,可以看到目前已经创建的数据连接及对应的连接状态,如下图所示:
该连接状态中包含活动连接数及空闲连接数,其中显示数字分别表示:
「活动连接数/最大活动连接数」、「空闲连接数/最大空闲连接数」。