资源迁移
1. 功能概述
离线开发资源支持跨环境迁移，其迁移逻辑和操作入口均与BI资源保持一致。
适用场景：测试迁移生产，当严格执行测试、生产分离时，需要将已经完成修改的资源从测试环境迁移至生产，降低在生产改动资源内容的频率，保证两个环境内容一致性，提升迁移效率。
迁移方式：
-
在线迁移，适合测试、生产网络互通的客户，通过在管理中心-运维管理-资源迁移集中配置、对应资源页面点击迁移，完成将测试资源同步生产环境。详见在线迁移。
-
离线迁移，适合测试、生产网络隔离的客户，通过在测试环境的管理中心-运维管理-资源迁移导出资源包，再在生产环境的同路径下导入，完成将测试资源同步生产环境。
2. 迁移逻辑
2.1. 名词解释
-
导出设置-导出上游资源：不勾选时，会导出选中的离线开发任务及其使用的数据集、数据账户等资源，但数据集的上游资源不会导出；勾选则会带上使用资源的上游资源，比如带上数据集的数据账户、上游ETL，在导入时可选择部分不做导入；
-
导入设置-资源ID是否变更：
- 导入选择ID不变时，迁移的资源id保持不变直接导入，下次导入相同资源时会对首次导入的资源进行更新。
- 导入选择ID改变时，会将迁移的所有资源id变更后导入，下次导入相同资源时由于id发生了变更，不会自动更新资源，而是创建新资源。
2.2. 迁移路径
功能入口：管理中心 > 资源管理 > 资源迁移。
Step 1. 迁移前说明
版本：建议同一版本。
功能开关：请确保两个环境功能一致。
Step 2. 导出合适的资源包
支持导出自己有权限的离线开发任务。
应用包名称：支持最长20字符的名称，可以用如日期、内容等唯一标识名字表意，方便后续查询；
导出设置：
【导出上游资源】：首次迁移建议勾选，除非相关上游资源在目标环境已存在；非首次迁移，一般不做勾选；
资源选择：选择对应资源类型的待导出资源。
点击导出后，请点击迁移记录tab下载资源包，当资源较多时会存在一定的等待时长。
Step 3. 导入资源包
资源导入：仅支持上传zip包文件，即系统导出的文件；
资源解析：
-
资源ID是否变更
- 选择是，导入资源ID改变，常用于以下场景：1）一次性导入无后续迭代需求；2）目标环境多个域都需要有该资源；
- 选择否，导入资源ID不变，常用于以下场景：1）导入目标环境后还需要通过迁移持续迭代；2）期望保证目标环境同一资源唯一。
- 由于离线开发任务本身支持引用其他离线开发任务，为了避免导入多个不同id但内容相同子任务，建议导入资源ID保持不变，或者将父任务一次性全部选中并导出。
-
解析列表
- 导入前展示资源类型、资源名称、导入前资源ID、导入方式，可选导入或不导入，但请确认不导入的上游资源在目标环境是有同ID资源存在的，否则导入可能会失败；
- 导入后会新增展示导入后资源ID、路径、导入状态，请保留这个页面直到完成Step3。
如导入存在报错，请根据报错信息进行调整并重新导入。
- 当选择的是ID不变，可直接重新导入调整后资源包；
- 当选择的是ID变化，需注意清理之前成功生成的资源。
3. 可能的失败原因
| 失败的资源类型 | 报错说明 | 报错实例 |
|---|---|---|
| 整包 | 功能开关关闭，需联系观远csm打开该功能。 | - |
| 整包 | 超过功能license限制，需联系观远商务。 | 错误信息：[message] = 该应用包含大屏，目前大屏数量超过上限 |
| 离线开发任务 | 输入数据集不在导入包内 | 输入数据集 XXX 未匹配 |
| 离线开发任务 | 数据账户不在导入包内 | 数据账户 XXX 未匹配 |
| 离线开发任务 | 子任务不在导入包内 | 子任务 XXX 未匹配 |
| 离线开发任务 | ETL不在导入包内 | ETL XXX 未匹配 |
| 离线开发任务 | 数据集规定同目录下不能有同名。请在导出环境修改数据集名称再做导入。 | 输出数据集目录中存在同名文件，请修改 |
| 卡片 | ID变更时，导入路径失效，可修改导入路径重新导入。 | 附件文件路径/guandata-store/images/bb021cf8dd1004239939ede7.jpg无效 |
| ETL | ETL输入数据集不在导入包内 | 输入数据集 未匹配 |
| ETL | 数据集规定同目录下不能有同名。请在导出环境修改数据集名称再做导入。 | 输出数据集目录中存在同名文件，请修改 |
| 数据集 | 同ID数据集在目标环境被删除过请使用ID变更导入或在导出环境复制一个数据集，替换使用 | 当前数据集在目标环境已经被删除，无法重复导入 |
| 数据集 | 目标环境为多域，且其他域存在同ID的数据集，导致无法导入请使用ID变更导入或在导出环境复制一个数据集，替换使用 | 其他域存在相同的数据集id，无法重复导入数据集到当前域 |
| 数据集 | 数据集存在同ID字段被删除。请使用ID变更导入或在导出环境复制一个数据集，替换使用 | Duplicate entry 't991094c76a394229b308950-a23d2757620fc47b7a6e0534' for key 'ds_fd' |
| 数据账户 | 数据账户名称唯一，但ID不一致，需在导出环境重命名数据账户 | 数据账户名称重复 |