资源迁移

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】直接跳转对应资源，数据账户需手动搜索一下。

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