观远 BI

资源迁移

创建于 2023-11-03 / 最近更新于 2024-07-30 / 1575
字体: [默认] [大] [更大]

1. 迁移功能概述

适用场景

场景1 测试迁移生产:当严格执行测试、生产分离时,需要将已经完成修改的资源从测试环境迁移至生产,降低在生产改动资源内容的频率,保证两个环境内容一致性,提升迁移效率。

场景2 总部(/总行)模板同步分公司(/分行):当总部的数据规范或仪表板模板期望能够同步到分公司时,可使用迁移功能将总部模板同步至其它环境。

场景3 OEM厂商在客户环境做仪表板初始化:将观远BI集成入其他B端平台后,可以通过迁移功能,完成仪表板初始化或仪表板行业模板的迁移,并持续更新。

功能介绍

在线迁移,适合测试、生产网络互通的客户,通过在管理中心-运维管理-资源迁移集中配置、对应资源页面点击迁移,完成将测试资源同步生产环境。

离线迁移,适合测试、生产网络隔离的客户,通过在测试环境的管理中心-运维管理-资源迁移导出资源包,再在生产环境的同路径下导入,完成将测试资源同步生产环境。

2.迁移逻辑

名词解释

  • 导出设置-导出上游资源:此时会带选中资源的上游资源,比如导出仪表板会带上上游的数据账户、数据集、ETL,在导入时可选择部分不做导入。

  • 关联资源:不在资源血缘页面展示的资源,如仪表板的关联资源会展示具体的卡片,数据集的关联资源会展示全局参数、自定义驱动等。

资源迁移逻辑图示

导入选择ID改变时

image.png

导入选择ID不变时

image.png

3.使用限制

各类限制已体现于最佳实践-step1.迁移前说明和step4.成功导入后配置检查项中。

  • 支持管理员使用,如需支持普通用户使用,需通过自定义角色给到普通用户相关rbac;

  • 迁移时各类资源的资源权限、数据集的行列权限、脱敏模板也不会迁移;

  • 为保障数据账户安全性,不支持迁移数据账户密码相关信息;

  • 为避免性能问题和迁移耗时过久的风险,不支持迁移数据;

  • 部分特殊配置、资源迁移可能未覆盖到,需重新检查,如自定义字体、组件模板。

4.最佳实践

功能入口

管理中心-运维管理-资源迁移

image.png

Step 1. 迁移前说明

版本:建议同一版本。

功能开关:请确保两个环境功能一致。

如需支持普通用户做迁移,可进行如下设置:

管理员配置端

当需支持普通用户可做迁移,需在【管理中心-权限管理-角色权限配置】路径下,给普通用户角色配置功能权限;

image.png

Step 2. 导出合适的资源包

支持导出自己有权限的仪表板、数据大屏、移动轻应用、桌面应用、ETL、数据集。

应用包名称:支持最长20字符的名称,可以用如日期、内容等唯一标识名字表意,方便后续查询;

导出设置:

【导出上游资源】:首次迁移建议勾选,除非相关上游资源在目标环境已存在;非首次迁移,一般不做勾选;

资源选择:选择对应资源类型的待导出资源。

image.png

点击导出后,请点击迁移记录tab下载资源包,当资源较多时会存在一定的等待时长。

image.png

注意:V6.5.0版本后新增支持卡片数据集。

Step 3. 导入资源包

资源导入:仅支持上传zip包文件,即系统导出的文件;

资源解析:

  • 资源ID是否变更

    • 选择是,导入资源ID改变,常用于以下场景:1)一次性导入无后续迭代需求;2)目标环境多个域都需要有该资源;

    • 选择否,导入资源ID不变,常用于以下场景:1)导入目标环境后还需要通过迁移持续迭代;2)期望保证目标环境同一资源唯一。

  • 解析列表

    • 导入前展示资源类型、资源名称、导入前资源ID、导入方式,可选导入或不导入,但请确认不导入的上游资源在目标环境是有同ID资源存在的,否则导入可能会失败;

image.png

    • 导入后会新增展示导入后资源ID、路径、导入状态,请保留这个页面直到完成Step3。

如导入存在报错,请根据报错信息进行调整并重新导入。

    • 当选择的是ID不变,可直接重新导入调整后资源包;

    • 当选择的是ID变化,需注意清理之前成功生成的资源。

image.png

Step 4. 成功导入后配置检查项

请按本列表顺序从上而下依次检查资源问题,可以通过导入后列表页面点击【导入后资源ID】直接跳转对应资源,数据账户需手动搜索一下。

资源类型

检查的内容和可能存在的问题

数据账户

出于密码保密性考虑,数据账户密码需要重新输入,添加使用者权限。

数据集

出于数据集可能会很大,存在出现性能问题的风险,不作数据迁移。

当存在直连数据集或抽取数据集,需手动运行更新,并检查更新配置、数据行列权限模板、数据脱敏模板、添加用户权限。

当存在文件数据集,需手动替换数据集,并检查数据行列权限模板、数据脱敏模板、添加用户权限。

当存在填报数据集、FTP数据集,需手动检查填报功能是否正常。

目前不支持迁移的数据集类型有第三方数据集相关(二维火、销售易、问卷网、微信公众号、三千客、金数据)、滚动计划数据集、账户数据集。

ETL

需手动运行ETL,并检查更新配置、添加用户权限。

仪表板

检查快捷查询、添加用户权限;

如仪表板使用了部分特殊资源,需检查,如室内地图、自定义icon图标、用户属性、自定义字体、组件模板。

大屏

检查用户权限;

轻应用

检查用户权限;

桌面应用

检查用户权限。

Step 5. 导入失败时可能存在的情况


导入失败的资源类型

报错说明

报错实例

整包

功能开关关闭,需联系观远csm打开该功能。


整包

超过功能license限制,需联系观远商务。

错误信息:[message] = 该应用包含大屏,目前大屏数量超过上限

卡片

ID变更时,导入路径失效,可修改导入路径重新导入。

附件文件路径[/guandata-store/images/bb021cf8dd1004239939ede7.jpg](51)无效

ETL

ETL输入数据集不在导入包内

输入数据集 未匹配

ETL

数据集规定同目录下不能有同名。

请在导出环境修改数据集名称再做导入。

输出数据集目录中存在同名文件,请修改

数据集

同ID数据集在目标环境被删除过

请使用ID变更导入或在导出环境复制一个数据集,替换使用

当前数据集在目标环境已经被删除,无法重复导入

数据集

目标环境为多域,且其他域存在同ID的数据集,导致无法导入

请使用ID变更导入或在导出环境复制一个数据集,替换使用

其他域存在相同的数据集id,无法重复导入数据集到当前域

数据集

数据集存在同ID字段被删除。

请使用ID变更导入或在导出环境复制一个数据集,替换使用

Duplicate entry 't991094c76a394229b308950-a23d2757620fc47b7a6e0534' for key 'ds_fd'

数据账户

数据账户名称唯一,但ID不一致,需在导出环境重命名数据账户

数据账户名称重复


5 人点赞过