一键升级RDS MySQL至PolarDB MySQL版

逻辑迁移（DTS数据同步）方式

逻辑迁移（DTS数据同步）方式中，不收取DTS数据同步任务的费用（不支持虚商用户、聚石塔用户、国际站用户以及RAM用户（子账号）等账号参加该免费活动），仅收取目标PolarDB集群的费用。

• DTS数据同步任务：

  30天内免费，超过30天将开始计费。费用信息，请参见DTS计费概述。

• 目标PolarDB集群：

  • 计费类型为按量付费时，则集群在整个升级流程中不计费，而是在如下操作后才开始正常按量计费：

    • 迁移完成后（包括升级流程中完成迁移操作）。

      说明

      • 迁移完成以中断RDS实例和PolarDB集群的DTS数据同步链路为准。

      • 迁移需在30天内完成。到期后，将关闭迁移功能，RDS实例和PolarDB集群均恢复读写状态，脱离复制关系。

    • 停止迁移后（包括预校验失败时的放弃迁移操作以及升级流程中取消迁移操作）。

      此时目标PolarDB集群已创建，但一键升级流程已停止。若您不需要使用目标PolarDB集群，请及时释放集群。

  • 计费类型为Serverless时，则在集群的状态变为运行中后，即开始计费。

  • 计费类型为包年包月时，则在创建集群时需预支付对应的费用。

物理迁移（物理复制）方式

物理迁移（物理复制）方式中，整个升级流程不收取额外费用，仅收取目标PolarDB集群的费用。

• 计费类型为按量付费时，则集群在整个升级流程中不计费，而是在如下操作后才开始正常按量计费：

  • 迁移完成后（包括升级流程中完成迁移操作）。

    说明

    • 迁移完成以中断RDS实例和PolarDB集群的同步链路为准。

    • 迁移需在30天内完成。到期后，将关闭迁移功能，RDS实例和PolarDB集群均恢复读写状态，脱离复制关系。

  • 停止迁移后（包括预校验失败时的放弃迁移操作以及升级流程中取消迁移操作）。

    此时目标PolarDB集群已创建，但一键升级流程已停止。若您不需要使用目标PolarDB集群，请及时释放集群。

• 计费类型为Serverless时，则在集群的状态变为运行中后，即开始计费。

• 计费类型为包年包月时，则在创建集群时需预支付对应的费用。

【推荐】控制台操作

以下为您简要说明一键升级操作流程。详细操作步骤说明，请参见升级步骤。

1. （可选）白名单检查

   若您的RDS实例存在只读实例，且只读实例的白名单配置与主实例不一致。为确保只读实例的白名单能够自动同步至PolarDB集群，您需将只读实例的白名单合并至主实例的白名单配置中。

   说明

   PolarDB集群的白名单配置适用于整个集群，不支持对各个节点进行单独配置。因此，完成迁移后，建议您对PolarDB集群的白名单及数据库账号权限进行重新审查。

2. 创建PolarDB集群

   请前往PolarDB集群购买页面，选择创建方式为从RDS迁移，并指定源RDS的版本与实例，以购买一个PolarDB集群。购买完成后，系统将进行初始化、预检查及全量数据同步等操作。在此期间，集群的状态为创建中，请您耐心等待。

   说明

   逻辑迁移（DTS数据同步）时，可能会出现预检查失败等错误情况，您需要根据错误信息进行相应的处理。处理完成后，可以单击继续迁移以继续一键升级流程。如果当前错误信息的处理会影响您的在线业务，您可以选择单击放弃迁移以中止一键升级流程。

3. （可选）地址补齐

   带地址切换功能可以保留原有数据库连接地址，使得应用程序无需修改任何连接配置即可切换至PolarDB集群。但仅能切换RDS实例与PolarDB集群同时存在的连接地址。

   1. 您可以根据实际情况选择是否在PolarDB集群上补齐相关连接地址。

   2. 检查连接地址的SSL加密状态，RDS实例与PolarDB集群连接地址的SSL加密状态需保持一致。

4. 迁移切换

   当PolarDB集群的复制延迟小于60秒时，您可以进行业务切换。单击迁移切换，交换RDS实例和PolarDB集群的读写状态（即将RDS实例修改为只读，将PolarDB集群修改为可读可写），同时更换数据复制方向（即将PolarDB集群的新增数据同步到RDS实例）。

   重要

   • 在进行迁移切换时，如果您选择使用带地址切换，请务必仔细阅读带地址切换注意事项。此外，请注意，切换过程中业务可能会中断1～5分钟。

   • 迁移切换完成后，如果您发现数据存在异常或其他问题，可以进行迁移回滚操作，以便迅速恢复到升级前的状态。之后，您还可以继续选择取消迁移操作，恢复到切换之前的状态。

5. （可选）源实例DTS任务切换

   若RDS实例存在关联的DTS链路（非一键升级流程中逻辑迁移的DTS数据同步链路），您可使用此功能修改（替换）DTS同步或迁移任务的源或目标库实例，平滑切换关联业务。

6. 完成迁移

   当业务数据迁移已完成，并且在PolarDB集群上稳定运行后，若后续不再需要使用数据同步，您可以单击完成迁移以结束一键升级流程。

7. （可选）退订或释放RDS实例

   当业务已在PolarDB集群上稳定运行且不再需要RDS实例时，可以进行退订或释放RDS实例。

API操作

以下为您简要说明一键升级操作流程。详细操作步骤说明，请参见升级步骤以及相关API文档。

1. （可选）白名单检查

   若您的RDS实例存在只读实例，且只读实例的白名单配置与主实例不一致。为确保只读实例的白名单能够自动同步至PolarDB集群，您需将只读实例的白名单合并至主实例的白名单配置中。

   说明

   PolarDB集群的白名单配置适用于整个集群，不支持对各个节点进行单独配置。因此，完成迁移后，建议您对PolarDB集群的白名单及数据库账号权限进行重新审查。

2. CreateDBCluster - 创建PolarDB集群

   调用创建集群API时，请求参数SourceResourceId需为源RDS实例所在地域，CreationOption需为MigrationFromRDS，且SourceResourceId需为源RDS实例ID。调用完成后，系统将进行初始化、预检查及全量数据同步等操作。在此期间，集群的状态为创建中，请您耐心等待。

3. DescribeDBClusterMigration - 查询PolarDB集群的迁移状态

   当返回参数MigrationStatus为RDS2POLARDB_SYNCING时，表示系统已完成全量数据的同步，正在进行增量同步。

   说明

   逻辑迁移（DTS数据同步）时，可能会出现预检查失败（参数MigrationStatus为PRE_CHECK_FAIL）等错误情况，您需要根据错误信息（参数Comment）进行相应的处理。处理完成后，可以在控制台单击继续迁移暂时没有继续迁移API以继续一键升级流程。如果当前错误信息的处理会影响您的在线业务，可以在控制台单击放弃迁移以中止一键升级流程。

4. ModifyDBClusterMigration - 切换迁移任务

   当DescribeDBClusterMigration的返回参数DelayedSeconds小于60秒时，您可以进行业务切换。交换RDS实例和PolarDB集群的读写状态（即将RDS实例修改为只读，将PolarDB集群修改为可读可写），同时更换数据复制方向（即将PolarDB集群的新增数据同步到RDS实例）。

   重要

   • 在进行迁移切换时，如果您选择使用带地址切换，请务必仔细阅读带地址切换注意事项。此外，请注意，切换过程中业务可能会中断1～5分钟。

   • 迁移切换完成后，如果您发现数据存在异常或其他问题，可以调用ModifyDBClusterMigration回滚迁移任务，以便迅速恢复到升级前的状态。之后，您还可以继续选择调用CloseDBClusterMigration取消迁移，恢复到切换之前的状态。

5. （可选）ModifyDtsJobEndpoint - 修改DTS任务的源或目标库实例

   若RDS实例存在关联的DTS链路（非一键升级流程中逻辑迁移的DTS数据同步链路），您可以修改（替换）DTS同步或迁移任务的源或目标库实例，平滑切换关联业务。

6. CloseDBClusterMigration - 完成迁移

   当业务数据迁移已完成，并且在PolarDB集群上稳定运行后，若后续不再需要使用数据同步，您可以结束一键升级流程。

7. （可选）退订或释放RDS实例

   当业务已在PolarDB集群上稳定运行且不再需要RDS实例时，可以进行退订或释放RDS实例。