1. 概述
1.1 版本
| BI 服务器版本 | 功能变更 |
|---|---|
| 5.1.12 | 资源迁移支持导出导入「数据连接」 |
| 5.1.15 | 资源导入时，自动检测导入资源与当前工程版本是否一致 |
1.2 应用场景
在使用数据决策系统时，往往会先使用测试环境系统进行部署开发，确定完全没问题后再迁移至正式系统。
因此就需要从测试环境往正式环境增量迁移仪表板、业务包等。
使用 FineBI 数据决策系统时，一般先在测试环境系统上进行开发部署，确认无误后再迁移到正式系统中。
FineBI 支持将「数据连接」从测试系统增量迁移到正式系统。
1.3 功能简介
超管登录数据决策系统，点击「管理系统>智能运维>资源迁移」，分为「资源导出」、「资源导入」两部分。
本文仅介绍迁移资源类型为「数据连接」时的操作方法。
1.4 注意事项
1）资源迁移功能仅超级管理员支持，即使给次级管理员分配了智能运维的权限，也不能进行资源迁移。
2）正式工程需购买「智能运维」功能点才可使用「资源迁移」功能。
3）请确保在资源迁移过程中，没有其他人使用超级管理员账号，否则部分执行请求可能被取消。
4）不建议在个人 PC 端工程开发模板后，再以资源迁移的形式同步到公司工程。
因为个人 PC 端没有管理员维护，经常会因为 JAR 包不同步或资源以及配置不同步的问题导致资源迁移失败，运维成本会很高。
2. 准备工作
2.1 确认版本
资源迁移之前，请确保资源导入和导出的 FineBI 工程使用的版本一致（包括 JAR 包时间）。
管理员可在「管理系统>注册管理>版本信息」下查看 JAR 包时间，如下图所示：
若版本不一致，可通过升级来确保版本一致，详情参见：升级指南索引。
注：5.1.15 及之后版本的 BI 工程，在资源导入时，若上传资源对应的工程和当前工程版本不一致，则无法上传。
提示：无法导入，即将导入的资源需要的工程版本：XXX。当前工程版本：XXX。请确保工程版本一致！
2.2 系统备份
资源导入前建议对测试系统和正式系统均进行 系统备份，如下图所示：
注：备份迁移到的 MySQL 数据库需要选择 utf8_bin 的排序规则。
2.3 确认数据库大小写
若系统配置了 配置外接数据库 ，在资源迁移前，请确保正式系统和测试系统的「数据库默认字符校验规则」都为「大小写敏感」。
以 Mysql 为例：
2.3.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.3.2 查看设置结果
如下图所示：
2.4 确认插件和驱动
1）若数据连接需依赖第三方插件，目前只支持 JSON 数据集和 Mysql8 数据连接，其他插件类型不适配，会导入失败。
2）数据连接迁移只迁移配置。驱动jar包、kerberos认证文件、JNDI 配置文件等都不会迁移，需要手动配置/放置。
请在进行数据连接迁移前，确认正式工程下是否提前安装依赖的相关数据连接插件，否则将导致导入失败。
请在进行数据连接迁移前，确认正式工程下是否提前安装依赖的相关数据连接驱动，否则将导致导入的数据连接不可使用。
3. 测试系统下资源导出
超级管理员登录数据决策系统，选择「管理系统>智能运维>资源迁移>资源导出」，如下图所示：
| 设置 | 简介 |
|---|---|
| 资源类型 | 资源类型为「数据连接」 数据连接列表可多选，数据连接的所有配置（基础配置、高级配置）都导出。 数据连接的密码加密导出，keytab 密钥路径不支持导出、迁移后需要手动输入。 导出文件到本地，文件名默认为：resource.zip |
| 同时导出原始Excel附件 | 迁移资源类型为「数据连接」时，该选项不生效 |
| 同时导出超链跳转模板 | 迁移资源类型为「数据连接」时，该选项不生效 |
| 同时导出权限配置 | 如不勾选，数据连接导入到「正式系统」中时，会继承正式系统中的权限。 如勾选该选项，数据连接导出导入时，会将「测试系统」中的权限实体同时导出导入。 |
4. 正式系统下资源导入
4.1 上传文件
超级管理员登录数据决策系统，选择「管理系统>智能运维>资源迁移>资源导入」，如下图所示：
注1：资源导入前建议进行 系统备份，其中备份迁移到的 MySQL 数据库需要选择 utf8_bin 的排序规则。
注2：单次只允许上传单个压缩文件。
系统会获取导入文件所包含的资源，包含类型、平台路径、物理资源、权限信息及导入方式。
| 设置 | 说明 |
|---|---|
| 类型 | 数据连接 |
| 平台路径 | 平台路径为「导出系统」的数据连接名称 |
| 物理资源 | - |
| 权限信息 | 点击「详情」可查看权限信息 其中会提示是否有部门/角色/用户在被导入系统中的缺失情况 |
| 导入方式 | 在导入时，系统会对资源进行检测，检测是否与系统现有资源有冲突。 冲突检验以资源的原始名与其在平台中的路径名为准。 分为直接导入和覆盖导入 直接导入：与系统中已有资源没有冲突，默认选中。 覆盖导入：与系统中已有资源有冲突，默认不选中且高亮，点击 |
| 冲突检测 | 平台路径：路径冲突 |
4.2 导入文件
勾选需要上传的资源，点击「导入」，点击「确定」。
若导入失败，显示失败的原因（如：导入不支持的插件类型数据连接或者导入工程没有安装插件）；若导入成功，则资源即时生效。如下图所示：
