资源迁移

智能数据洞察 DataWind 支持“项目管理员”将本系统中某一项目的资源文件（数据集、仪表盘）下载，并上传到其他环境/项目下，以实现资源的跨环境/项目迁移。资源迁移功能，适合集团型业务，区分测试、生产环境，实现测试环境资源到正式环境的资源迁移，既能够让业务用户看数据，推广产品应用，又能够将制作者与查看者分离，实现有序管理。
产品通过导出与导入的方式实现跨项目资源迁移。原理是将A系统的A1项目下仪表盘和数据集打包导出，再导入到A系统的A2项目使用，或者导入到B系统的任一项目下使用。

2.1 规则说明

使用前提： 操作人必须是项目管理员
支持范围： DataWind 系统中某一项目空间下的仪表盘、数据集与关联数据集可支持资源迁移
（1）数据集：抽取数据 除数据源类型为 kafka、飞书电子表格/飞书多维表格，直连数据 除数据源类型为上传文件（Excel/CSV）之外，其他数据集均可支持资源迁移；
（2）仪表盘：支持迁移仪表盘；
（3）关联数据集：关联数据集支持导出导入，使用了关联数据集所做图表的仪表盘也支持导入导出。

如果仪表盘中的图表，来自于做过关联（Join）的数据集 A 和 B，其中 A 数据集支持迁移，B 数据集不支持迁移，那么在资源导入（新环境/项目）时，需要选择新环境/项目中的数据集与 A 关联

2.2 功能入口

选择某一项目，点击导航条的「项目中心」，在左下有「资源迁移」的模块，点击即可看到该功能界面，包含资源导出与导入的功能。

3.1 导出资源

首先，进入「项目中心」-「资源迁移」-「资源导出」，选择仪表盘/数据集/关联数据集，并勾选需要的资源。

3.1.1 导出数据集

选择资源类型为数据集，然后选中需要导出的数据集，确定权限信息是否同步导出，之后点击导出即可；

3.1.2 导出仪表盘

（1）因为仪表盘是多个图表的集合，对应一个或多个数据集。所以，仪表盘从A项目导出时，如未勾选对应数据集，导入后对应的图表将无法正常展示。通常勾选数据集共同导出。

（2）在 B 项目下上传资源包文件后，产品将解析仪表盘中使用的数据集。用户需要对这些数据集逐一检查，关联 B 项目内已有的数据集。如果 B 项目内没有对应的数据集，可以不选关联数据集，该数据集将同步导入 B 项目。

（3）导出过程中可以选择是否「同步导出权限信息」，即资源的授权列表。选择导出，则导入后无需再次配置资源权限；不选择导出，就需要在导入后配置该资源权限。

注意： 用户组授权、数据权限（行权限、列权限）无法导出，只能在新项目中重新配置

（4）导出之后，会在操作导出的设备上下载一个.res的资源文件

仪表盘“新增/覆盖”导入导出具体细节包含如下：

• 支持全局指标/维度，全局指标/维度与导入的仪表盘配置保持一致。

• 支持关系图。关系图与导入的仪表盘配置保持一致，关系图所配置的指标卡作为仪表盘图表同等处理。

• 支持 sheet 页顺序保持不变，sheet 页顺序与导入的仪表盘配置保持一致。

• 支持导入导出时将全局筛选器所应用的子查询内容同步导入导出，实现将子查询来源图表当成类似于当前仪表盘的图表处理。

• 支持仪表盘主题。对于新增的情况：在主题列表里面同名则替换，不同名则在同类型下新增，若当前操作者无该类型权限，则在个人类型下面新增。对于覆盖的情况：保留被覆盖数据集的主题不变。

• 支持参数。对于新增的情况：遇到公共参数同名则替换，若没有参数则跟随新增项目全数据集参数，如果已经存在部分数据集参数则无法导入成功。对于覆盖的情况：不处理参数。

• 导出的仪表盘中有针对不勾选的数据集，导出时不做校验（针对镜像数据集等不支持导出的数据集不支持勾选）。
• 当 A 引用数据集字段 B，即使 B 在图表中没有使用或出现，B 也能正常导出，A也能正常使用。

3.1.3 导出关联数据集

（1）在导出的资源类型中选择【关联数据集】。

（2）当用户切换到“关联数据集”时，下方显示当前项目中该用户有管理权限的关联数据集。用户勾选后点击导出则导出该关联数据集的逻辑模型信息及其子数据集信息。若子数据集没有管理权限则在导出时，会提示“数据集导出失败：你没有关联数据集xxx，xxx的子数据集xxx,xxx的管理权限”。

（3）导出权限时要带上子数据集的权限。

3.2 导入资源

3.2.1 导入概述

（1）进入「项目中心」-「资源迁移」-「资源导入」，选择仪表盘/数据集/关联数据集资源导入.

（2）拖拽或点击选择资源文件上传，可选择在之前项目中导出的.res资源包文件。之后产品进行解析，解析后可勾选导入资源。
（3）如果资源包中只有数据集，则只需选中数据集、对应数据连接与权限信息，点击导入即可。

（4）若资源包中有仪表盘，还需为对应数据集选择当前项目下的替换数据集。

• 如果导出时选择数据集，并且该数据集支持导出，该选项可选，选择本项目数据集后则会替换为新的数据集，如果不选择，会导入原数据集。如果导出时未选择数据集，或者选择的数据集不支持导出，该选项为必选。

• 如果导入时未选中本项目要关联的数据集（如上图所示），则会显示配置数据连接的选项，列出当前项目空间下的所有可用数据连接来供选择。

（5）确认是否「同步导入权限信息」，如果不选择同步那么导入资源的权限就默认归属于操作人。选择同步且导出时点选过同步，则会带上该资源的资源权限信息。
（6）确认导入内容和相应关联信息后，点击导入。
（7）提示导入成功后，进入仪表盘或数据集界面，在仪表盘或数据集列表中可以看到新仪表盘/数据集，里面为导入资源。

3.2.2 关联数据集导入

（1）在资源导入界面，上传文件包，格式仅支持“.res和.mig文件。
（2）导入方式可以选择新建或者覆盖。

（3）对于新建方式，上传后，界面会展示所选的关联数据集包含的子数据集清单；子数据集会优先从本项目中选择同名同类型且当前用户有编辑权限的数据集进行关联，否则被新增到本项目。用户可选择是否导入权限信息，若不勾选，那么所有资源和配置都会归属于当前用户。

子数据集清单说明：

• a.待导入数据集：显示所选的关联数据集下所引用的子数据集名称；
• b.引用该数据集的关联数据集：当前数据集所归属的关联数据集名称；
• c.本项目数据集：即当前项目中所要关联的数据集，自动关联用户有编辑权限的且与待导入数据集同名同类型的数据集。

除了成功关联的情况，还有以下2种情况需要注意：

• a.若本项目存在同名数据集，但数据集类型不一致或者当前用户没有编辑权限，建议申请相应权限或修改该数据集名称；
• b.若本项目不存在同名数据集，将会被新增到本项目；

（4）对于覆盖方式，用户可以选择要导入的数据集和被覆盖的数据集，以及是否刷新权限状态。

• 若以数据集A覆盖B，则公共字段和个人字段均将与A保持一致，其中公共字段按配置的映射关系进行覆盖。个人字段同名则覆盖。请注意覆盖操作对 行列数据权限的影响。覆盖完成后，记得按需回溯数据集数据。
• 子数据集会优先从本项目中选择同名同类型且当前用户有编辑权限的数据集进行关联，否则被新增到本项目。
  

（1）以下数据集不支持资源迁移：
a.抽取数据：
除数据源类型为kafka、飞书电子表格/飞书多维表格；
b.直连数据 ：
除数据源类型为上传文件（Excel/CSV）之外，其他数据集均可支持资源迁移。
在A项目勾选数据集导出后，将生成资源包文件，可上传至 B 项目。在 B 项目导入时候，需要选择 B 项目的数据连接信息。

（2）对于不支持导入的数据源类型，必须选择关联数据集，否则无法导入。

• 关联数据集与 A 项目中的原数据集，需保证关键字段名与字段类型一致：仪表盘中图表使用到的维度、指标、筛选字段和仪表盘公共筛选器关联的字段。

（3）资源迁移模块支持从当前项目中同类型(个人或公共)资源判断是否有同名资源，若有同名则使用新环境中已有的参数，不同名则在该类型下新增。

5.1 仪表盘导入后，图表报错列不存在

仪表盘导入时，如果选择关联数据集，且关联数据集与原数据集字段不完全一致，则有可能出现仪表盘中图表无法正常展示，报错列不存在的情况。
此时需要进行字段检查，修改和补充关联数据集字段。

5.2 仪表盘导入后，数据与原项目中不一致

仪表盘导入时，如果选择关联数据集，且发现数据与原项目中不一致的情况，可能是关联数据集与原数据集数据不一致，需要对比检查两个数据集的信息。