资源迁移

1.1 版本

1.2 应用场景

使用 FineBI 系统时，一般先在测试环境系统上进行开发部署，确认无误后再迁移到正式系统中。

FineBI支持将目录、数据集、数据连接、仪表板等资源从测试系统增量迁移到正式系统。

1.3 功能简介

FineBI 以插件形式提供资源迁移功能，支将目录、数据集、数据连接、仪表板等资源从测试系统到正式系统的增量迁移。

插件安装成功后，管理员登录FineBI系统，点击「管理系统>智能运维>资源迁移」，分为「资源导出」、「资源导入」两部分，如下图所示：

• 资源导出：将需要迁移到其他系统的资源从服务器中导出，以供后续迁移。
  

• 资源导入：将需要迁移的资源在新系统中导入，即迁移至新系统。

1.4 注意事项

1）正式工程需购买「智能运维」功能点才可使用「资源迁移」功能。

2）请确保在资源迁移过程中，没有其他人使用超级管理员账号，否则部分执行请求可能被取消。

3）不建议在个人 PC 端工程开发模板后，再以资源迁移的形式同步到公司工程。

      因为个人 PC 端没有管理员维护，经常会因为 JAR 包不同步或资源以及配置不同步的问题导致资源迁移失败，运维成本会很高。

2.1 获取插件

FineBI6.0版本，资源迁移功能需要依赖「资源迁移」插件。

插件获取请联系技术支持。技术支持联系方式：「服务平台>在线支持」、电话「400-811-8890」

插件安装方法参照： 插件管理

2.2 确认版本

资源迁移之前，请确保资源导入和导出的 FineBI 工程使用的版本一致（包括 JAR 包时间）。

管理员可在「管理系统>注册管理>版本信息」下查看 JAR 包时间，如下图所示：

若版本不一致，可通过升级来确保版本一致，详情参见：6.0升级。

注：在资源导入时，若上传资源对应的工程和当前工程版本不一致，则无法上传。

       提示：无法导入，即将导入的资源需要的工程版本：XXX。当前工程版本：XXX。请确保工程版本一致！

2.3 系统备份

资源导入前建议对测试系统和正式系统均进行 系统备份，如下图所示：

注：备份迁移到的 MySQL 数据库需要选择 utf8_bin 的排序规则。

2.4 确认数据库大小写

若系统配置了 外接数据库 ，在资源迁移前，请确保正式系统和测试系统的「数据库默认字符校验规则」都为「大小写敏感」。

以 Mysql 为例：

2.4.1 进行设置

设置方式：若配置了外接数据库，连接 FineDB 数据库，打开 FINE_CONF_ENTITY 表，设置字符校验规则为 utf8_bin，输入命令如下：

ALTER TABLE fine_conf_entity MODIFY id VARCHAR(255) CHARACTER SET utf8 COLLATE utf8_bin;  #设置列的默认校验规则
ALTER TABLE fine_conf_entity DEFAULT CHARACTER SET utf8 COLLATE utf8_bin;  #设置表的校验规则

2.4.2 查看设置结果

如下图所示：

2.5 确认插件和驱动

1）若数据连接需依赖第三方插件，目前只支持迁移 JSON 数据集和 Mysql8 数据连接，其他插件类型不适配，会导入失败。

2）权限导出插件生成的服务器数据集，不支持迁移，会导入失败。

3）数据连接迁移只迁移配置。驱动jar包、kerberos认证文件、JNDI 配置文件等都不会迁移，需要手动配置/放置。

• 请在进行数据连接迁移前，确认正式工程下是否提前安装依赖的相关数据连接插件，否则将导致导入失败。

• 请在进行数据连接迁移前，确认正式工程下是否提前安装依赖的相关数据连接驱动，否则将导致导入的数据连接不可使用。

2.6 确认数据连接

• 若需要进行数据连接迁移，需要在资源迁移导入前，保证正式系统已创建好了数据连接，且该数据连接名需与测试系统一致，否则资源无法迁移成功。

• 若迁移的是服务器数据集创建的仪表板，则在迁移前需要保证正式系统上创建好相同名称的服务器数据集。

• 服务器数据集若依赖相关数据连接，请确认将相关数据连接导入正式工程，否则导入的服务器数据集无法使用。
  

2.7 确认用户

1）用户

在资源导入时，系统中必须有资源包的资源所有者。

比如测试系统中数据表的创建者是Anna，那么在正式系统中也必须有一个用户叫Anna。否则导入时需要修改资源的所有者。

2）用户类型

在资源迁移过程中，需要BI数据表的创建者的用户类型保持一致。

比如测试系统中数据表创建者为「分析用户」，那么在正式系统中也需要将其添加到「分析用户」中。

2.8 迁移自定义地图

若模板中调用了自定义地图，需要将地图 json 文件拷贝到正式工程下。

在%FineBI%/webroot/WEB-INF/assets/map/image路径下，将需要迁移的 json 文件拷贝到正式工程对应路径下，如下图所示：

3.1 选择资源

管理员登录FineBI系统后，进入「管理系统>智能运维>资源迁移」，选择「资源导出」。

选择需要导出的资源类型，选择每种类型下需要导出的具体内容，支持多选。如下图所示：

可导出的资源如下：

3.2 选择导出全部依赖资源

比如A数据集基于B数据集创建，将A数据集从测试系统迁移到正式系统中，如需正常使用A数据集，需要将依赖的B数据集也导入。

因此选择的资源类型为「目录、我的分析、公共数据」时，可选择是否「导出全部依赖资源」。如下图所示：

该按钮会导出这三种资源类型里的「数据集、组件、仪表板」依赖的资源。

该按钮仅对当前资源类型生效，需要逐个设置。

可导出的依赖资源如下：

3.3 选择同时导出的资源

比如A数据集设置了定时更新，将A数据集从测试系统迁移到正式系统中，用户可能需要将设置的定时更新也导入。

因此在导出时，支持选择同时导出「同时导出Finereport链接跳转模板」、「原始Excel附件」、「公共链接的设置项」、「定时更新任务」、「同时导出权限配置」。如下图所示：

同时导出配置，对导出的全部资源类型生效。

可同时导出的资源如下：

3.4 导出的文件

导出后会生成 resources.zip 文件，如下图所示：

4.1 上传文件

管理员登录 FineBI 系统，选择「管理系统>智能运维>资源迁移>资源导入」，点击「上传文件」，如下图所示：

注1：资源导入前建议进行 系统备份，其中备份迁移到的 MySQL 数据库需要选择 utf8_bin 的排序规则。

注2：单次只允许上传单个压缩文件。

上传文件时，系统会自动获取当前可用的空闲内存大小，当上传文件大小 <（当前可用的空闲内存大小-256MB）时，允许上传文件，当上传的文件大小 >（当前可用的空闲内存大小-256MB）时，触发限制，报错「当前剩余内存 xxxMB，文件大小 xxxMB，为防止内存溢出，不允许上传」，如下图所示：

上传文件成功后，系统会获取导入文件所包含的资源，包含资源类型、资源名称、资源所有者、资源路径、导入方式和资源信息对比。

注1：在导入资源时，若该路径下存在转义名相同的资源，会自动对导入的资源的转义名进行修改，变为「转义名1」。

注2：不支持空文件夹导入。

注3：资源不允许导入时，资源所有者显示为「未知用户」，可点击修改资源所有者为系统中的其他用户，点击「确定」生效。

• 如果资源是公共数据中的数据集，修改资源所有者仅会改变该资源的所有者用户ID。

• 如果资源是我的分析中的主题，修改资源所有者，会将该主题的路径调整为对应用户的分析下的路径，并刷新用户ID。

4.2 导入文件

勾选需要上传的资源，点击「导入」，点击「确定」。如下图所示：

若导入失败，显示失败的原因（如：导出工程和导入工程中存在同名同路径但是类型不同）；若导入成功，则资源即时生效。如下图所示：

注：由于对应的环境配置不同 IP 端口号会改变，资源迁移后的仪表板公共链接需要重新进行链接分享。

4.3 数据更新

若迁入的基础表资源为「抽取数据」，导入到新的系统中需要手动进行 数据更新 ，或者直接进行 全局更新 。

更新后才能看到导入的数据表均正常显示，如下图所示：

注：若导入数据表为 Excel 数据集或者以 Excel 数据集为基础表制作的数据集，则必须进行文件夹更新或者全局更新。

       若导入的数据表为数据库表或者 SQL 数据集，则可以对导入的表进行单表更新。