历史版本28 :资源迁移 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 版本编辑

         FineBI 版本                    JAR 包版本         
5.12020-01-15

2. 描述编辑

1.1 应用场景

在使用 FineBI 数据决策系统时,往往会先使用测试环境系统进行部署开发,确定完全没问题后再迁移至正式系统。因此就需要从测试环境往正式环境增量迁移仪表板、业务包等。

1.2 功能介绍

FineBI 提供了资源迁移功能,支持仪表板文件及管理系统配置从测试系统到正式系统的增量迁移。

资源迁移的步骤主要分为两步:「资源导出 」「资源导入」。管理员登录系统后,进入管理系统>智能运维>资源迁移,可以看到存在资源导出和导入的节点,如下图所示:

222

本文介绍迁移的详细步骤。

3. 资源导出编辑

3.1 资源类型

资源导出即表示将需要迁移到其他系统的资源从服务器中导出,以供后续迁移。资源导出的类型分为目录和BI数据表。

  • 目录:为挂出到系统中的所有仪表板,如下图所示:

1.png

  • BI 数据表:为数据准备下业务包中的所有表,包含基础表和自助数据集,但不包含我的自助数据集,如下图所示:

1.png

3.2 导出目录

导出目录即可以选择导出挂载到系统目录中的仪表板及其依赖资源,包括仪表板使用到的基础表和自助数据集,仪表板的配置、原始名、转义名、所属用户、挂载目录、是否公共链接、分享情况等都会被导出,可同时选择导出仪表板的权限配置。

比如将目录下的城市分析仪表板从测试系统迁移到正式系统中,且 Alice 用户有查看该仪表板及业务包使用权限,demo 用户没有,因此需要先将其资源进行导出。

1)选择目录>城市分析>城市数据分析,点击选择依赖资源,如下图所示:

1.png

2)此时会获取该仪表板所使用的数据表(包含基础表和自助数据集)资源信息,如下图所示:

222

3)可以选择对应的数据表资源同时导出。若正式系统已存在仪表板需要的数据表资源,在此处可不选择导出。此处选择全部依赖的资源导出,勾选全部数据表资源,并勾选同时导出权限配置,单击导出按钮。如下图所示:

注:若导出的数据表原始名(即上图资源中数据表括号内的名称)与正式系统中一样,将覆盖掉正式系统中的数据表,因此此处需确认好再进行导出导入操作。

1.png

注:此处若依赖的资源来自我的自助数据集,在导出时也可以进行选择。后续导入时,也将导入到对应用户的我的自助数据集下。

4)此处导出权限配置会导出该仪表板对应的权限配置,包含 目录权限 及对应的 业务包权限 。在后续导入后,该仪表板对应的权限设置则不会发生变化。

支持勾选同时导出原始excel附件需要 2020.1.15 之后的 FineBI 版本支持),若仪表板使用到 Excel 数据集制作,可直接将原始Excel 附件与仪表板资源一起导出,这样在后续的导入中不需要再重新上传 Excel 数据集,直接随仪表板导入。

5)导出后会生成 resources.zip 文件,如下图所示:

222

3.3 导出 BI 数据表

导出 BI 数据表可选择数据准备中的基础表和自助数据集导出,数据表以分组业务包的形式排列,可选取的最小粒度为表。导出时表的相关配置信息、转义、关联、更新设置、实时设置、内存化设置和路径设置(所在业务包)等都会被导出。

导出数据表同样可以选择依赖资源,包含直接使用的自助数据集、基础表和在关联路径上经过的相关表。导出时也可勾选导出权限配置,导出数据表权限时将同时导出所在业务包的权限。

注:我的自助数据集下的表不可选择导出,如果需要导出可以将我的自助数据集中的数据移动到公共业务包。  

1)比如需要迁移地区访问统计自助数据集,且该业务包 Alice 用户有查看权限,demo 用户没有。在 BI 数据表中勾选该表,点击选择依赖资源,如下图所示:

1.png

2)此时会获取该表的依赖资源,包含该表使用的自助数据集、基础表和关联路径上的表。如下图,地区访问统计的来源表包括互联网地区访问统计(自助数据集)、访问统计事实表(基础表)、地区维度表(基础表)、用户信息维度表(基础表)、推广渠道维度表(基础表),括号内的均为该表的原始名。如下图所示:

1.png


3)全选依赖资源并勾选同时导出权限配置,点击导出按钮,如下图所示:


1.png

4)此处导出权限配置会导出该数据表对应的权限配置。在后续导入后,该仪表板对应的权限设置则不会发生变化。

支持勾选同时导出原始excel附件(需要 2020.01.15 之后的 FineBI 版本支持),若数据表使用到 Excel 数据集字段或者是 Excel 数据集,可直接将原始 Excel 附件导出,这样在后续的导入中不需要再重新上传 Excel 数据集,直接随数据表导入。

5)导出后,与导出目录一致,同样会生成 resources.zip 文件,如下图所示:

222

4. 资源导入编辑

资源导入即表示将需要迁移的资源在新系统中导入,也即迁移至新系统。之前在测试系统获取的资源类型包含目录和 BI 数据表,导入时,也按照资源类型来介绍。

4.1 导入目录

4.1.1 资源导入

1)本文 3.2 章节介绍了获取的城市分析仪表板资源,使用管理员账号登录需要迁移到的系统 B ,进入管理系统>智能运维>资源迁移,选择资源导入,如下图所示:

222

2)点击上传文件,并选择之前获取的城市分析仪表板资源 resources.zip ,单击打开,如下图所示:

222

3)此时系统会获取该文件所包含的资源,包含文件类型、平台路径、物理资源、权限信息及导入方式。如下图所示:

222

4.1.2 冲突检测

1)在导入时,系统会对资源进行检测,检测是否与系统现有资源有冲突,冲突检验以资源的原始名为准。若导入的数据在系统中有冲突,导入方式会显示为覆盖导入;若与系统中已有资源没有冲突,则会显示直接导入。点击222按钮可以查看到详细说明,如下图所示:

222

2)该客户维度表显示了路径冲突,即表示在该路径下已存在原始名叫做「客户维度表」的数据表。对于有冲突的资源,可以选择不导入,保留系统中原有的;也可以选择勾选资源,覆盖导入。

此处选择对「合同回款事实表」覆盖导入,客户维度表维持系统中的原表,勾选相应资源后,点击导入按钮并选择确定。如下图所示:

222

4.1.3 导入完成

1)导入成功后则显示导入完成,并列出导入成功项和失败项。如下图所示:

222

2)单击查看导入成功资源列表按钮可查看详细资源,如下图所示:

222

4.1.4 数据更新

1)此时系统新增了目录城市分析,且在城市分析下,新增了城市数据分析仪表板。但此时查看该仪表板,仍然可能显示报错。这是由于原先导出的基础表资源为抽取数据保存,导入到新的系统中也需要先进行数据更新,才能正常查看对应的仪表板。如下图所示:

222

2)此时在对应业务包下进行 数据更新 ,或者直接进行 全局更新 。更新以后,能看到导入的数据表均能正常显示,如下图所示:

注1:此处若仪表板使用的是 Excel 数据,需要进入到资源使用的数据业务包中,在对应数据表下选择更新 Excel,并将源数据的 Excel 表重新上传并更新。

注2:若为 2020.01.15 之后的版本中,使用 Excel 数据的仪表板资源导入后,则不需要重新上传 Excel 数据,导入资源时 Excel 数据会同时导入。

222

4.1.5 效果查看

1)再查看之前目录下的城市数据分析仪表板,即可看到该表正常显示。如下图所示:

222

2)同时也可以去仪表板下该表创建的位置对仪表板继续编辑,如下图所示:

222

4.1.6 权限查看

1)在本文 3.2 章节导出时选择导出权限配置,因此在导入时,该城市数据分析仪表板的权限与原系统中保持一致。即 Alice 用户有查看该仪表板及业务包使用权限,demo 用户没有。分别使用 Alice 和 demo 用户登录 B 系统,如下图所示:

222

222

4.2 导入 BI 数据表

4.2.1 导入数据

1)导入 BI 数据表与导入目录类似,使用管理员账号登录 B 系统,进入管理系统>智能运维>资源迁移,点击资源导入,并选择 2.3 章节获取的地区访问统计表资源导入。可以看到检测出的冲突及获取的资源表,选择对应表直接和覆盖导入。如下图所示:

222

2)导入完成后,点击能看到导入表的对应路径信息。如下图所示:

222

4.2.2 效果查看

1)此时数据准备下的相应业务包,对于在迁移前系统中抽取数据的基础表需要先进行 数据更新 才能显示。更新以后,可以看到互联网行业业务包中的对应导入表显示正常,未分组业务包下的地区访问统计表也正常显示,如下图所示:

222

222

2)由于 3.3 节导出时选择了导出权限配置,因此数据表所在业务包的权限也与迁移前保持一致。该业务包 Alice 用户有查看权限,demo 用户没有。进入管理系统>权限管理,可以看到 Alice 用户有该业务包的使用权限,demo 用户没有该业务包任何权限,如下图所示:

222

222

注:测试系统和正式系统中用户名不同步,可能会导致资源迁移出现问题。因此在迁移时需要保持系统用户名的一致。

5. 注意事项编辑

5.1 资源迁移支持范围

资源迁移功能仅超级管理员支持,次级管理员尽管分配了智能运维的权限,也不能进行资源迁移。

5.2 资源迁移实质

1)资源迁移的时候,尽管在依赖资源中选择了依赖的数据表/自助数据集导出,但实际上仅为导出该表的相关配置信息,包括表来源、创建的用户、表名、关联路径等,实际该表的数据是没有迁移的。需要在新的系统中创建名字一样的数据连接,从而根据迁移的配置信息获取完全一致的表。

2)若资源迁移使用的是 Excel 上传的数据集,则在 2020-1-15 之后的版本中可直接选择导出原始 Excel 附件,新系统中可直接导入,不需要重新上传文件。

5.3 迁移数据连接

1)数据连接是不可以迁移的,目前 FineBI5.1 版本还不支持。需要在资源迁移导入前,保证正式系统已创建好了数据连接,且该数据连接名需与测试系统一致,否则资源无法迁移成功。

2)若迁移的是服务器数据集创建的仪表板,则在迁移前需要保证正式系统上创建好相同名称的服务器数据集。

5.4 普通用户挂出的模板迁移

普通用户申请挂出的模板,在资源迁移的时候操作是一样的。即管理员在管理系统>智能运维>资源迁移中,选择已挂出的普通用户模板,选择导出依赖资源;再至新系统中,导入该资源即可。

新系统中导入的资源,模板默认创建在普通用户账号中,挂出在对应目录下。

5.5 数据库大小写

在资源迁移前,请确保正式系统和测试系统的数据库默认字符校验规则都为大小写敏感。以 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)查看设置结果,如下图所示:

1579240842669112.png

5.6 分享仪表板

在资源迁移过程中,如果仪表板涉及到分享或者创建公共链接,则需要仪表板的创建者在正式系统和测试系统中保持一致的权限。比如测试系统中仪表板创建者为 BI 设计用户,那么在正式系统中也需要将其添加到 BI 设计用户中。