迁移

相关概念

• 源实例：待迁移的PolarDB-X 1.0实例。

• 源数据库（源库）：源实例中要进行迁移的数据库。

• 目标实例：要迁移至的PolarDB-X 2.0实例。

• 目标数据库（目标库）：目标实例中创建好的用于迁移至的数据库。

• 目标中继数据库：如果目标数据库为AUTO模式，目标实例中需创建用于结构迁移中继的DRDS模式数据库。

费用

评估迁移功能可免费使用。

注意事项

• 当前评估迁移功能已面向中国地域发布。

• 当前评估迁移工具仅支持结构迁移和数据迁移，其中结构迁移仅支持表和视图。数据库账号，数据库白名单配置，备份策略以及其他实例参数均需手动配置。

• 当前评估迁移工具支持的是库级别的数据迁移功能，可选择多个库同时迁移。

• 迁移将会对全量数据进行迁移。执行迁移前需评估源库和目标库的性能，因此建议在业务非高峰期执行迁移。迁移时会占用源和目标库一定读写资源，导致数据库的负载上升。

• 在迁移期间，请勿对源实例和目标实例执行扩容、缩容、迁移热点表、变更拆分键和变更DDL等操作，否则会导致数据迁移任务失败、数据不一致或扩缩容失败等问题。

• 当前仅支持将存储类型为RDS for MySQL的数据库迁移至PolarDB-X 2.0。

• 当前支持将PolarDB-X 1.0迁移至PolarDB-X 2.0的DRDS模式数据库和AUTO模式数据库。迁移至AUTO模式数据库时，目标实例版本需在5.4.16-16717637及以上。如果目标库为AUTO模式，需要创建中继DRDS模式数据库并授予相应权限。中继DRDS模式数据库名称需要设置为目标AUTO库名+_drdstoauto。例如目标库为AUTO模式数据库mytest，则目标中继库为DRDS模式数据库mytest_drdstoauto。同时，由于AUTO模式数据库与DRDS模式数据库存在一定架构差异，建议进行业务测试和性能测试后再切换。

• 迁移期间对目标实例性能有一定影响，不建议迁移至已有线上服务的数据库实例。

迁移前准备

此外，请使用相同阿里云账号在相同地域购买PolarDB-X 2.0实例作为目标实例，且：

• 已在目标实例中创建账号。

• 已在目标实例中创建数据库作为目标数据库，且目标数据库的字符集与源数据库的字符集保持一致。

  例如，若您PolarDB-X 1.0实例中的数据库字符集为utf8mb4，请在PolarDB-X 2.0实例中创建好字符集同为utf8mb4的数据库。

  说明

  您可以执行如下命令，查看PolarDB-X 1.0实例中数据库的字符集。

  SELECT default_character_set_name FROM information_schema.SCHEMATA WHERE schema_name = '...'

• 如果目标数据库为AUTO模式，需在目标实例中创建DRDS模式数据库作为目标中继数据库，且目标中继数据库的字符集与源数据库的字符集保持一致，并授予读写权限。

  例如，若您源库为PolarDB-X 1.0实例中的数据库，名称为“test1”，目标库为PolarDB-X 2.0中的AUTO模式数据库，名称为“test2”，则需在PolarDB-X 2.0实例中创建DRDS模式数据库作为中继数据库，名称为“test2_drdstoauto”。

• 创建的目标数据库需授权给创建的账号，确保账号有目标数据库的读写权限。

• 迁移过程中，评估迁移工具不会覆盖目标数据库中已有的表。但请确认目标数据库中不存在与源数据库中的表相同名称的表。否则预检查阶段会提示报错，且无法成功启动数据迁移任务。

步骤1：创建迁移任务

1. 登录PolarDB分布式版控制台。

2. 在页面左上角选择目标实例所在地域。

3. 在实例列表页，单击PolarDB-X 2.0页签。

4. 右侧导航栏单击评估迁移。

5. 单击创建迁移任务。

6. 在打开的页面中，填写如下内容。

   配置项		说明
   任务名称		为本次评估与迁移任务自定义一个名称。
   PolarDB-X 1.0实例	实例地域	选择源PolarDB-X 1.0实例所在的地域。 源PolarDB-X 1.0实例与目标PolarDB-X 2.0实例需要位于同一地域下。
   	实例	选择源PolarDB-X 1.0实例。 当选定实例地域后，该地域下的所有PolarDB-X 1.0的实例将展示在实例下拉列表中。
   	数据库	当选定实例后，将展示该实例下的所有数据库。选择PolarDB-X 1.0实例下要迁移的源数据库。
   	数据库账号、数据库密码	对已选定的数据库拥有读写权限的账号及对应的密码。
   PolarDB-X 2.0实例	选择实例	选择与PolarDB-X 1.0实例处于同一地域下的PolarDB-X 2.0实例。 当选定源实例地域后，该地域下所有PolarDB-X 2.0实例将展示在实例下拉列表中。 说明 您也可以选择新购实例，并设置想要购买的实例的规格和节点数，了解对应的价格。
   	数据库	选择PolarDB-X 2.0实例下要迁移至的目标数据库。
   	数据库账号、数据库密码	对已选定的数据库有读写权限的账号及对应的密码。

   

7. 单击开始兼容性评估，进入下一步。

   重要

   如果您选择自行验证兼容性，单击跳过，单击下一步，可以跳过兼容性评估步骤。

步骤2：兼容性评估

迁移任务创建完成后，将进行SQL兼容性评估。由于PolarDB-X 1.0与2.0的SQL语法略有差异，因此需要进行兼容性评估，评估源库的SQL语句是否完全兼容PolarDB-X 2.0的SQL语法。若不兼容，则需要对其进行针对性的改造。

当单击开始兼容性评估后，评估迁移工具将开始评估源库和目标库的兼容性情况。

若存在未通过的SQL，您可根据PolarDB-X 2.0的SQL语法说明进行SQL改造。您也可先进行下一步，然后在迁移开始并校验完成后，对相关SQL进行改造。

步骤3：预检查

兼容性评估完成后，单击下一步，进入预检查阶段。

预检查项有：

• CONNECTIVITY：检查源实例对应库和目标实例对应库的用户名、密码、权限是否正确，以及两者的网络连通性。若失败，请检查实例的用户名、密码以及相关权限是否正确。如目标库为AUTO模式数据库，则需额外检查目标中继库的用户名、密码以及相关权限是否正确。

• BINLOG_CONFIG：检查源实例底层RDS的Binlog参数设置是否正确。请确保已将源实例底层RDS的binlog_row_image设置为FULL，binlog_rows_query_log_events设置为ON。

• TABLE_META：检查源实例库表的主键情况。若失败，请检查源实例待迁移的表，确保其需具有主键约束或非空唯一键约束。

• CONFLICT：检查目标库中是否存在与源库中同名的表。若失败，请修改目标库中对应同名表的名称。

如存在报错项，可修复后点击重试，再次进行预检。

请确保所有预检查项均通过，否则无法开始迁移。

步骤4：结构迁移

当预检查的所有结果均通过后，单击开始结构迁移。

步骤5：数据迁移

1. 当结构迁移通过后，单击开始数据迁移。

   开始迁移后，返回迁移任务列表，能够查看任务状态。

   

2. 开始迁移后，任务状态变为迁移准备中，包括创建表和一些资源的准备。

   说明

   若出现错误提示，或者一直处于该状态下无法开始迁移，请联系我们。

3. 迁移准备完成后，任务状态变为数据迁移中。单击任务名称，在界面左侧单击数据迁移详情，该阶段将对全量数据和增量数据进行迁移。

   迁移过程说明如下：

   1. 首先开始全量迁移。开始迁移后，源库中待迁移对象的存量数据，将全部迁移到目标库中。

   2. 全量迁移的进度达到100%后，将立即自动开始增量迁移，将全量迁移开始后源库中更新的数据持续同步至目标库。

      增量迁移是一个动态持续进行的过程，在业务正式切换到目标库以前不会停止。

   3. 增量迁移开始后，当源库和目标库中的数据大致追平后（表现为增量迁移的延迟在30秒以内），将自动开始数据校验，校验源库和目标库中的数据一致性，确保两端数据是动态一致的。

   说明

   以上三种迁移状态若出现错误提示，或者长时间没有进度变化，请联系我们。