资源迁移

概述

功能介绍

在线迁移，适合测试、生产网络互通的客户，通过在「资源迁移 > 在线迁移设置」页面集中配置、对应资源页面点击迁移，完成将测试资源同步生产环境。详见在线迁移。

离线迁移，适合测试、生产网络隔离的客户，通过在「资源迁移」页面集中配置导出资源包，再在生产环境的同路径下导入，完成将测试资源同步生产环境。详见离线迁移。

适用场景

• 测试迁移生产：当严格执行测试、生产分离时，需要将已经完成修改的资源从测试环境迁移至生产，降低在生产改动资源内容的频率，保证两个环境内容一致性，提升迁移效率。
• 总部（/总行）模板同步分公司（/分行）：当总部的数据规范或仪表板模板期望能够同步到分公司时，可使用迁移功能将总部模板同步至其它环境。
• OEM厂商在客户环境做仪表板初始化：将观远BI集成入其他B端平台后，可以通过迁移功能，完成仪表板初始化或仪表板行业模板的迁移，并持续更新。

迁移逻辑

名词解释

• 导出设置 > 导出上游资源：此时会带选中资源的上游资源，比如导出仪表板会带上上游的数据账户、数据集、ETL，在导入时可选择部分不做导入。
• 关联资源：不在资源血缘页面展示的资源，如仪表板的关联资源会展示具体的卡片，数据集的关联资源会展示全局参数、自定义驱动等。

资源迁移逻辑图示

导入选择ID改变时

导入选择ID不变时

说明

在线迁移导入资源ID默认不变。

使用限制

各类限制已体现于操作步骤中。

• 支持管理员使用，如需支持普通用户使用，需通过自定义角色给到普通用户相关rbac；
• 迁移时各类资源的资源权限、数据集的行列权限、脱敏模板也不会迁移；
• 为保障数据账户安全性，不支持迁移数据账户密码相关信息；
• 为避免性能问题和迁移耗时过久的风险，不支持迁移数据；
• 部分特殊配置、资源迁移可能未覆盖到，需重新检查，如自定义字体、组件模板。
• 在线迁移暂仅支持跨环境迁移，不支持同环境多域间迁移、即环境A域a迁移到环境A域b，不支持跨环境多域间迁移、即环境A迁移到环境B域a，再迁移到环境B域b；

离线迁移

功能入口

管理中心 > 资源管理 > 资源迁移。

迁移前说明

• 版本：建议同一版本。

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

• 如需支持普通用户做迁移，可在「管理中心＞用户管理＞角色配置」路径下，给普通用户角色配置功能权限；

  

操作步骤

导出合适的资源包

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

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

• 导出设置：选择是否够炫「导出上游资源」。首次迁移建议勾选，除非相关上游资源在目标环境已存在；非首次迁移，一般不做勾选。

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

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

说明

V6.5.0版本后新增支持卡片数据集导出。

导入资源包

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

• 资源解析：

  • 资源ID是否变更：

    • 选择是，导入资源ID改变，常用于以下场景：
      1. 一次性导入无后续迭代需求；
      2. 目标环境多个域都需要有该资源；
    • 选择否，导入资源ID不变，常用于以下场景：
      1. 导入目标环境后还需要通过迁移持续迭代；
      2. 期望保证目标环境同一资源唯一。

  • 解析列表：

    • 导入前展示资源类型、资源名称、导入前资源ID、导入方式，可选导入或不导入，但请确认不导入的上游资源在目标环境是有同ID资源存在的，否则导入可能会失败；
      
    • 导入后会新增展示导入后资源ID、路径、导入状态，请保留这个页面直到完成导入。
      

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

• 当选择的是ID不变，可直接重新导入调整后资源包；
• 当选择的是ID变化，需注意清理之前成功生成的资源。

成功导入后配置检查项

请按本列表顺序从上而下依次检查资源问题，可以通过导入后列表页面点击「管理中心 ＞ 用户管理 ＞ 角色配置」直接跳转对应资源，数据账户需手动搜索一下。

资源类型	需检查的内容和可能存在的问题
数据账户	出于密码保密性考虑，数据账户密码需要重新输入，添加使用者权限。
数据集	出于数据集可能会很大，存在出现性能问题的风险，不作数据迁移。当存在直连数据集或抽取数据集，需手动运行更新，并检查更新配置、数据行列权限模板、数据脱敏模板、添加用户权限。当存在文件数据集，需手动替换数据集，并检查数据行列权限模板、数据脱敏模板、添加用户权限。当存在填报数据集、FTP数据集，需手动检查填报功能是否正常。目前不支持迁移的数据集类型有第三方数据集相关（二维火、销售易、问卷网、微信公众号、三千客、金数据）、滚动计划数据集、账户数据集。
ETL	需手动运行ETL，并检查更新配置、添加用户权限。
仪表板	检查快捷查询、添加用户权限；如仪表板使用了部分特殊资源，需检查，如室内地图、自定义icon图标、用户属性、自定义字体、组件模板。
大屏	检查用户权限；
轻应用	检查用户权限；
桌面应用	检查用户权限。

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

导入失败的资源类型	报错说明	报错实例
整包	功能开关关闭，需联系观远csm打开该功能。	-
整包	超过功能license限制，需联系观远商务。	错误信息：[message] = 该应用包含大屏，目前大屏数量超过上限
卡片	ID变更时，导入路径失效，可修改导入路径重新导入。	-
ETL	ETL输入数据集不在导入包内	输入数据集 未匹配
ETL	数据集规定同目录下不能有同名。请在导出环境修改数据集名称再做导入。	输出数据集目录中存在同名文件，请修改
数据集	同ID数据集在目标环境被删除过请使用ID变更导入或在导出环境复制一个数据集，替换使用	当前数据集在目标环境已经被删除，无法重复导入
数据集	目标环境为多域，且其他域存在同ID的数据集，导致无法导入请使用ID变更导入或在导出环境复制一个数据集，替换使用	其他域存在相同的数据集id，无法重复导入数据集到当前域
数据集	数据集存在同ID字段被删除。请使用ID变更导入或在导出环境复制一个数据集，替换使用	Duplicate entry 't991094c76a394229b308950-a23d2757620fc47b7a6e0534' for key 'ds_fd'
数据账户	数据账户名称唯一，但ID不一致，需在导出环境重命名数据账户	数据账户名称重复

在线迁移

功能入口

• 操作页面：资源页面 ＞ 操作

• 设置页面：管理中心 ＞ 资源管理 ＞ 资源迁移

迁移前说明

• 版本：建议同一版本。

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

操作步骤

迁移设置

一键迁移功能可由管理员自主决定是否开启，管理员可以按需在「管理中心＞资源管理＞资源迁移页面配置」是否开启相应功能。

• 当仅有管理员需要做资源迁移时，迁移后资源所有者请选择固定用户，公司域、域名信息和目标域的管理员账号密码为必填。

  
  配置完毕，点击「测试连接」，查看是否可以连通。

• 当普通用户也需要做资源迁移时，迁移后资源所有者请选择跟随迁移用户，则每次迁移时需要输入目标环境自己的账号信息，公司域、域名信息为必填，其他信息在做迁移时才需要填入。

  

一键迁移

迁移时建议按资源血缘链路（数据账户、数据集、ETL、仪表板、大屏、应用资源）依次迁移。

如迁移仪表板时，需要同步迁移使用的数据集、ETL等。如果不是首次迁移，也需要注意使用的数据集模型结构是否发生了变化，一旦有变化也是需要进行迁移的。

1. 点击「查看资源血缘」。

   

2. 依次从上到下、从左到右点击资源，如数据账户、数据集，并跳转资源详情页面；

   

3. 依次进行单个资源迁移。

   

非首次迁移，则在对应资源详情页，迁移该资源即可。

如需普通用户迁移，则在线迁移入口在各个资源。

注意

因在线迁移有传输限制，使用批量迁移时请不要一次性选择太多资源，超过100M会导致任务失败。

迁移完成后配置检查项

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

资源类型	需检查的内容和可能存在的问题
数据账户	出于密码保密性考虑，数据账户密码需要重新输入，添加使用者权限。
数据集	出于数据集可能会很大，存在出现性能问题的风险，不作数据迁移。当存在直连数据集或抽取数据集，需手动运行更新，并检查更新配置、数据行列权限模板、数据脱敏模板、添加用户权限。当存在文件数据集，需手动替换数据集，并检查数据行列权限模板、数据脱敏模板、添加用户权限。当存在填报数据集、FTP数据集，需手动检查填报功能是否正常。目前不支持迁移的数据集类型有第三方数据集相关（二维火、销售易、问卷网、微信公众号、三千客、金数据）、滚动计划数据集、账户数据集。
ETL	需手动运行ETL，并检查更新配置、添加用户权限。
仪表板	检查快捷查询、添加用户权限；如仪表板使用了部分特殊资源，需检查，如室内地图、自定义icon图标、用户属性、自定义字体、组件模板。
大屏	检查用户权限；
轻应用	检查用户权限；
桌面应用	检查用户权限。

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

导入失败的资源类型	报错说明	报错实例
整包	功能开关关闭，需联系观远csm打开该功能。	-
整包	超过功能license限制，需联系观远商务。	错误信息：[message] = 该应用包含大屏，目前大屏数量超过上限
ETL	数据集规定同目录下不能有同名。 请在导出环境修改数据集名称再做导入。	输出数据集目录中存在同名文件，请修改
数据集	同ID数据集在目标环境被删除过 在导出环境复制一个数据集，替换使用	当前数据集在目标环境已经被删除，无法重复导入
数据集	目标环境为多域，且其他域存在同ID的数据集，导致无法导入 在导出环境复制一个数据集，替换使用	其他域存在相同的数据集id，无法重复导入数据集到当前域
数据集	数据集存在同ID字段被删除。 在导出环境复制一个数据集，替换使用	Duplicate entry 't991094c76a394229b308950-a23d2757620fc47b7a6e0534' for key 'ds_fd'
数据账户	数据账户名称唯一，但ID不一致，需在导出环境重命名数据账户	数据账户名称重复