#迁移管理

该功能由插件 «迁移管理» 提供， 包含在 专业版 及以上商业版本中

#介绍

用于将应用配置从一个应用环境迁移到另一个应用环境。迁移管理更侧重「应用配置」的迁移，如果需要全量的迁移，建议使用「备份管理器」的备份还原。

#安装

依赖 备份管理 插件，请确保已经安装并激活。

#流程与原理

将主数据库的数据表及数据，根据迁移规则，从一个应用迁移至另一个应用。需要注意的是不迁移外部数据库和子应用的数据。

#迁移规则

#内置规则

迁移管理是主数据库里所有数据表的迁移，目前支持以下五种规则：

• 仅结构：只迁移数据表结构，不涉及数据的插入或更新；
• 覆盖（清空并重新插入）：清空现有数据表中的所有记录，然后插入新数据；
• 插入或更新：如果记录存在则更新，不存在则插入；
• 插入时忽略重复：插入数据时，如果记录已存在，则忽略不做更新；
• 跳过：不进行任何处理。

备注：

• 覆盖、插入或更新、插入时忽略重复，也会同步表结构变化；
• 主键为自增 ID 或者无主键的数据表无 插入或更新 和 插入时忽略重复 规则；
• 插入或更新 和 插入时忽略重复 是通过主键来辨别记录是否存在。

#详细设计

#配置界面

配置迁移规则

启用独立规则

选择独立规则以及按当前独立规则处理的数据表

#迁移文件

#新建迁移

#执行迁移

应用环境变量检测（了解何为 环境变量）

如果.env中的 DB_UNDERSCORED 、USE_DB_SCHEMA_IN_SUBAPP 、DB_TABLE_PREFIX 、DB_SCHEMA 、 COLLECTION_MANAGER_SCHEMA 不一致，则会弹窗提示不能够继续迁移

如果缺失动态配置的环境变量或密钥就会弹窗提示用户，要在这里填写需要新增的环境变量或密钥，然后继续

应用插件检测，如果当前环境缺少插件就会弹窗提示，此时也可以选择继续迁移

#迁移日志

执行完迁移后，服务器上会保存执行日志文件，可以在线查看或下载。

在线查看执行日志文件时，还可以下载迁移数据结构时执行的SQL。

点击 过程 按钮可以查看已完成迁移执行过程

#回滚

执行迁移前，会自动对当前应用进行备份。如果迁移失败或结果不符合预期，可通过 备份管理器 进行回滚恢复。