1. 概述编辑
1.1 版本
FineBI 版本 | JAR 包 | 新增功能 |
---|---|---|
5.1 | 2019-01-15 | |
5.1 | 2020-01-15 | 支持将Excel数据集的原始Excel附件一起导出 |
1.2 应用场景
在使用数据决策系统时,往往会先使用测试环境系统进行部署开发,确定完全没问题后再迁移至正式系统。
因此就需要从测试环境往正式环境增量迁移仪表板、业务包等。
1.3 功能简介
FineBI 提供了资源迁移功能,支持仪表板文件及管理系统配置从测试系统到正式系统的增量迁移。
资源迁移的步骤主要分为两步:「资源导出 」「资源导入」。
资源导出即表示将需要迁移到其他系统的资源从服务器中导出,以供后续迁移。资源导出的类型分为目录和BI数据表。
资源导入即表示将需要迁移的资源在新系统中导入,也即迁移至新系统。
注:资源迁移功能仅超级管理员支持,次级管理员尽管分配了智能运维的权限,也不能进行资源迁移。
2. 准备工作编辑
在进行资源迁移之前请确保两个 BI 工程使用的版本一致(包括 JAR 包时间),可在管理系统>注册管理>BI模块查看 JAR 包时间,如下图所示:
若版本不一致,可进行升级来确保版本一致,详情参见:升级指南索引
3. 资源迁移目录编辑
3.1 导出目录
3.1.1 可导出资源范围
导出目录即可以选择导出挂载到系统目录中的仪表板。可导出资源如下所示:
可导出的资源范围 |
---|
|
3.1.2 示例
比如将目录下的城市分析仪表板从测试系统迁移到正式系统中,且 Alice 用户有查看该仪表板及业务包使用权限,demo 用户没有,因此需要先将其资源进行导出。
1)管理员登录系统后,进入管理系统>智能运维>资源迁移,选择资源导出,如下图所示:
2)选择目录>城市分析>城市数据分析,点击选择依赖资源,如下图所示:
3)此时会获取该仪表板所使用的数据表(包含基础表和自助数据集)资源信息,如下图所示:
4)可选择对应的数据表资源同时导出。若正式系统已存在仪表板需要的数据表资源,在此处可不选择导出。仪表板依赖资源支持导出范围如下所示:
仪表板的依赖资源支持导出范围 |
---|
|
此处选择全部依赖的资源导出,勾选全部数据表资源,勾选同时导出原始excel附件,勾选同时导出权限配置,单击导出按钮。如下图所示:
注:若导出的数据表原始名(即上图资源中数据表括号内的名称)与正式系统中一样,将覆盖掉正式系统中的数据表,因此此处需确认好再进行导出导入操作。
导出设置 | 说明 |
---|---|
同时导出原始excel附件 | 若仪表板使用到 Excel 数据集制作,可勾选同时导出原始excel附件,直接将原始Excel 附件与仪表板资源一起导出,这样在后续的导入中不需要再重新上传 Excel 数据集,直接随仪表板导入 |
导出权限配置 | 导出权限配置会导出该仪表板对应的权限配置,包含 目录权限 及对应的 业务包权限 。在后续导入后,该仪表板对应的权限设置则不会发生变化 |
5)导出后会生成 resources.zip 文件,如下图所示:
3.2 导入目录
3.2.1 资源导入
1)已经获取城市分析仪表板资源,使用管理员账号登录需要迁移到的系统 B ,进入管理系统>智能运维>资源迁移,选择资源导入,点击上传文件,如下图所示:
2)选择之前获取的城市分析仪表板资源 resources.zip ,单击打开,如下图所示:
3)此时系统会获取该文件所包含的资源,包含文件类型、平台路径、物理资源、权限信息及导入方式。如下图所示:
3.2.2 冲突检测
1)在导入时,系统会对资源进行检测,检测是否与系统现有资源有冲突,冲突检验以资源的原始名为准。
若导入的数据在系统中有冲突,导入方式会显示为覆盖导入;若与系统中已有资源没有冲突,则会显示直接导入。点击按钮可以查看到详细说明,如下图所示:
2)客户维度表显示了路径冲突,即表示在该路径下已存在原始名叫做客户维度表的数据表。对于有冲突的资源,可以选择不导入,保留系统中原有的;也可以选择勾选资源,进行覆盖导入。
此处选择对合同回款事实表覆盖导入,客户维度表维持系统中的原表,勾选相应资源后,点击导入按钮并选择确定。如下图所示:
3.2.3 导入完成
1)导入成功后则显示导入完成,并列出导入成功项和失败项。如下图所示:
2)单击查看导入成功资源列表按钮可查看详细资源,如下图所示:
3.2.4 数据更新
1)此时系统新增了目录城市分析,在城市分析下,新增了城市数据分析仪表板。但此时查看该仪表板,仍然可能显示报错。如下图所示:
这是由于原先导出的基础表资源为抽取数据保存,导入到新的系统中也需要先进行数据更新,才能正常查看对应的仪表板。
2)在对应业务包下进行 数据更新 ,或者直接进行 全局更新 。更新后则能看到导入的数据表均能正常显示,如下图所示:
注:2020-01-15之前的版本,若仪表板使用的是 Excel 数据,需要进入到资源使用的数据业务包中,在对应数据表下选择更新 Excel,并将源数据的 Excel 表重新上传并更新。
3.2.5 效果查看
1)查看之前目录下的城市数据分析仪表板,即可看到该表正常显示。如下图所示:
2)同时也可以去仪表板下该表创建的位置对仪表板继续编辑,如下图所示:
3.2.6 权限查看
1)在3.1.2 节导出时选择导出权限配置,因此在导入时,该城市数据分析仪表板的权限与原系统中保持一致。即 Alice 用户有查看该仪表板及业务包使用权限,demo 用户没有。使用 Alice 用户登录 B 系统,可以看到该目录和仪表板,如下图所示:
demo 用户登录 B 系统,不能看到该目录节点,如下图所示:
4. 资源迁移BI数据表编辑
4.1 导出 BI 数据表
4.1.1 可导出资源范围
导出 BI 数据表可选择数据准备中的表,可导出资源如下所示:
可导出的资源范围 |
---|
|
4.1.2 示例
1)管理员登录系统后,进入管理系统>智能运维>资源迁移,选择资源导出,如下图所示:
2)比如需要迁移地区访问统计自助数据集,且该业务包 Alice 用户有查看权限,demo 用户没有。在 BI 数据表中勾选该表,点击选择依赖资源,如下图所示:
3)此时会获取该表的依赖资源,BI数据表依赖资源支持导出范围如下所示:
BI数据表的依赖资源支持导出范围 |
---|
|
例如地区访问统计的来源表包括互联网地区访问统计(自助数据集)、访问统计事实表(基础表)、地区维度表(基础表)、用户信息维度表(基础表)、推广渠道维度表(基础表),括号内的均为该表的原始名。如下图所示:
4)此处选择全部依赖的资源导出,勾选全部数据表资源,勾选同时导出原始excel附件,勾选同时导出权限配置,单击导出按钮。如下图所示:
注:若导出的数据表原始名(即上图资源中数据表括号内的名称)与正式系统中一样,将覆盖掉正式系统中的数据表,因此此处需确认好再进行导出导入操作。
导出设置 | 说明 |
---|---|
同时导出原始excel附件 | 若仪表板使用到 Excel 数据集制作,可勾选同时导出原始excel附件,直接将原始Excel 附件与仪表板资源一起导出,这样在后续的导入中不需要再重新上传 Excel 数据集,直接随仪表板导入 |
导出权限配置 | 导出权限配置会导出该仪表板对应的权限配置,包含 目录权限 及对应的 业务包权限 。在后续导入后,该仪表板对应的权限设置则不会发生变化 |
5)导出后,同样会生成 resources.zip 文件,如下图所示:
4.2 导入BI数据表
4.2.1 资源导入
1)使用管理员账号登录需要迁移到的系统 B ,进入管理系统>智能运维>资源迁移,选择资源导入,点击上传文件,如下图所示:
2)选择之前获取的地区访问统计表资源 resources.zip ,单击打开,如下图所示:
3)此时系统会获取该文件所包含的资源,包含文件类型、平台路径、物理资源、权限信息及导入方式,选择对应表直接和覆盖导入。如下图所示:
4)导入完成后,点击能看到导入表的对应路径信息。如下图所示:
4.2.2 效果查看
1)此时数据准备下的相应业务包,对于在迁移前系统中抽取数据的基础表需要先进行 数据更新 才能显示。更新以后,可以看到未分组业务包下的地区访问统计表正常显示,如下图所示:
2)由于导出时选择了导出权限配置,因此数据表所在业务包的权限也与迁移前保持一致。该业务包 Alice 用户有查看权限,demo 用户没有。进入管理系统>权限管理,可以看到 Alice 用户有该业务包的使用权限,如下图所示:
demo 用户没有该业务包任何权限,如下图所示:
注:测试系统和正式系统中用户名不同步,可能会导致资源迁移出现问题。因此在迁移时需要保持系统用户名的一致。
5. 注意事项编辑
5.1 资源迁移实质
1)资源迁移的时候,尽管在依赖资源中选择了依赖的数据表/自助数据集导出,但实际上仅为导出该表的相关配置信息,包括表来源、创建的用户、表名、关联路径等,实际该表的数据是没有迁移的。需要在新的系统中创建名字一样的数据连接,从而根据迁移的配置信息获取完全一致的表。
2)若资源迁移使用的是 Excel 上传的数据集,则在 2020-1-15 之后的版本中可直接选择导出原始 Excel 附件,新系统中可直接导入,不需要重新上传文件。
5.2 迁移数据连接
1)数据连接是不可以迁移的,目前 FineBI5.1 版本还不支持。需要在资源迁移导入前,保证正式系统已创建好了数据连接,且该数据连接名需与测试系统一致,否则资源无法迁移成功。
2)若迁移的是服务器数据集创建的仪表板,则在迁移前需要保证正式系统上创建好相同名称的服务器数据集。
5.3 普通用户挂出的模板迁移
普通用户申请挂出的模板,在资源迁移的时候操作是一样的。即管理员在管理系统>智能运维>资源迁移中,选择已挂出的普通用户模板,选择导出依赖资源;再至新系统中,导入该资源即可。
新系统中导入的资源,模板默认创建在普通用户账号中,挂出在对应目录下。
5.4 数据库大小写
在资源迁移前,请确保正式系统和测试系统的数据库默认字符校验规则都为大小写敏感。以 Mysql 为例:
1)设置方式:使用第三方管理软件连接工程内置 HSQL 数据库 FineDB 后打开 FINE_CONF_ENTITY 表,设置字符校验规则为utf8_bin ,输入命令如下:
ALTER TABLE fine_conf_entity MODIFY id VARCHAR(255) CHARACTER SET utf8 COLLATE utf8_bin; #设置列的默认校验规则
ALTER TABLE fine_conf_entity DEFAULT CHARACTER SET utf8 COLLATE utf8_bin; #设置表的校验规则
2)查看设置结果,如下图所示:
5.5 分享仪表板
在资源迁移过程中,如果仪表板涉及到分享或者创建公共链接,则需要仪表板的创建者在正式系统和测试系统中保持一致的权限。比如测试系统中仪表板创建者为 BI 设计用户,那么在正式系统中也需要将其添加到 BI 设计用户中。