资源迁移

1. 迁移功能概述

适用场景

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

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

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

功能介绍

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

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

2.迁移逻辑

名词解释

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

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

资源迁移逻辑图示

导入选择ID改变时

导入选择ID不变时

3.使用限制

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

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

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

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

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

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

4.最佳实践

功能入口

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

Step 1. 迁移前说明

版本：建议同一版本。

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

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

管理员配置端

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

Step 2. 导出合适的资源包

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

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

导出设置：

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

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

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

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

Step 3. 导入资源包

资源导入：仅支持上传zip包文件，即系统导出的文件；

资源解析：

• 资源ID是否变更

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

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

• 解析列表

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

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

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

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

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

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不一致，需在导出环境重命名数据账户	数据账户名称重复