在线迁移
1. 迁移功能概述
适用场景
场景1 测试迁移生产:当严格执行测试、生产分离时,需要将已经完成修改的资源从测试环境迁移至生产,降低在生产改动资源内容的频率,保证两个环境内容一致性,提升迁移效率。
场景2 总部(/总行)模板同步分公司(/分行):当总部的数据规范或仪表板模板期望能够同步到分公司时,可使用迁移功能将总部模板同步至其它环境。
场景3 OEM厂商在客户环境做仪表板初始化:将观远BI集成入其他B端平台后,可以通过迁移功能,完成仪表板初始化或仪表板行业模板的迁移,并持续更新。
功能介绍
在线迁移,适合测试、生产网络互通的客户,通过在管理中心-运维管理-资源迁移集中配置、对应资源页面点击迁移,完成将测试资源同步生产环境。
离线迁移,适合测试、生产网络隔离的客户,通过在测试环境的管理中心-运维管理-资源迁移导出资源包,再在生产环境的同路径下导入,完成将测试资源同步生产环境。
2.迁移逻辑
资源迁移逻辑图示
在线迁移导入资源ID默认不变。
3.使用限制
各类限制已体现于最佳实践-step1.迁移前说明和step4.成功导入后配置检查项中。
-
支持管理员使用,如需支持普通用户使用,需通过自定义角色给到普通用户相关rbac;
-
暂仅支持跨环境迁移,不支持同环境多域间迁移、即环境A域a迁移到环境A域b,不支持跨环境多域间迁移、即环境A迁移到环境B域a,再迁移到环境B域b;
-
迁移时各类资源的资源权限、数据集的行列权限、脱敏模板也不会迁移;
-
为保障数据账户安全性,不支持迁移数据账户密码相关信息;
-
为避免性能问题和迁移耗时过久的风险,不支持迁移数据;
-
部分特殊配置、资源迁移可能未覆盖到,需重新检查,如自定义字体、组件模板。
4.最佳实践
功能入口
操作页面:资源页面-操作
设置页面:管理中心-运维管理-资源迁移
Step 1. 迁移前说明
版本:建议同一版本。
功能开关:请确保两个环境功能一致。
Step 2. 迁移设置
一键迁移功能可由管理员自主决定是否开启,管理员可以按需在管理中心-运维管理-资源迁移页面配置是否开启相应功能。
设置所需信息。
当仅有管理员需要做资源迁移时,迁移后资源所有者请选择固定用户,公司域、域名信息和目标域的管理员账号密码为必填。
配置完毕,点击测试连接,查看是否可以连通。
当普通用户也需要做资源迁移时,迁移后资源所有者请选择跟随迁移用户,则每次迁移时需要输入目标环境自己的账号信息,
公司域、域名信息为必填,其他信息在做迁移时才需要填入
Step 3. 一键迁移
迁移时建议按资源血缘链路(数据账户、数据集、ETL、仪表板、大屏、应用资源)依次迁移。
如迁移仪表板时,需要同步迁移使用的数据集、ETL等。如果不是首次迁移,也需要注意使用的数据集模型结构是否发生了变化,一旦有变化也是需要进行迁移的。
点击查看资源血缘;
依次从上到下、从左到右点击资源,如数据账户、数据集,并跳转资源详情页面;
依次进行单个资源迁移。
非首次迁移,则在对应资源详情页,迁移该资源即可。
如需普通用户迁移,则在线迁移入口在各个资源。
其它
注:因在线迁移有传输限制,使用批量迁移时请不要一次性选择太多资源,超过100M会导致任务失败。
Step 4. 导入后配置检查项
当完成迁移后,请按本列表顺序从上而下依次检查资源问题,可以通过导入后列表页面点击【导入后资源ID】直接跳转对应资源,数据账户需手动搜索一下。
资源类型 | 需检查的内容和可能存在的问题 |
数据账户 | 出于密码保密性考虑,数据账户密码需要重新输入,添加使用者权限。 |
数据集 | 出于数据集可能会很大,存在出现性能问题的风险,不作数据迁移。当存在直连数据集或抽取数据集,需手动运行更新,并检查更新配置、数据行列权限模板、数据脱敏模板、添加用户权限。当存在文件数据集,需手动替换数据集,并检查数据行列权限模板、数据脱敏模板、添加用户权限。当存在填报数据集、FTP数据集,需手动检查填报功能是否正常。目前不支持迁移的数据集类型有第三方数据集相关(二维火、销售易、问卷网、微信公众号、三千客、金数据)、滚动计划数据集、账户数据集。 |
ETL | 需手动运行ETL,并检查更新配置、添加用户权限。 |
仪表板 | 检查快捷查询、添加用户权限;如仪表板使用了部分特殊资源,需检查,如室内地图、自定义icon图标、用户属性、自定义字体、组件模板。 |
大屏 | 检查用户权限; |
轻应用 | 检查用户权限; |
桌面应用 | 检查用户权限。 |
Step 5. 导入失败时可能存在的情况
导入失败的资源类型 | 报错说明 | 报错实例 |
整包 | 功能开关关闭,需联系观远csm打开该功能。 | |
整包 | 超过功能license限制,需联系观远商务。 | 错误信息:[message] = 该应用包含大屏,目前大屏数量超过上限 |
ETL | 数据集规定同目录下不能有同名。 请在导出环境修改数据集名称再做导入。 | 输出数据集目录中存在同名文件,请修改 |
数据集 | 同ID数据集在目标环境被删除过 在导出环境复制一个数据集,替换使用 | 当前数据集在目标环境已经被删除,无法重复导入 |
数据集 | 目标环境为多域,且其他域存在同ID的数据集,导致无法导入 在导出环境复制一个数据集,替换使用 | 其他域存在相同的数据集id,无法重复导入数据集到当前域 |
数据集 | 数据集存在同ID字段被删除。 在导出环境复制一个数据集,替换使用 | Duplicate entry 't991094c76a394229b308950-a23d2757620fc47b7a6e0534' for key 'ds_fd' |
数据账户 | 数据账户名称唯一,但ID不一致,需在导出环境重命名数据账户 | 数据账户名称重复 |