升级步骤

前置检查

检查是否已创建PolarDB服务关联角色（仅限逻辑迁移）

在使用逻辑迁移（DTS数据同步）方式进行一键升级前，请先检查是否已创建PolarDB服务关联角色，以及是否已授予DTS访问云资源的权限。检查是否已创建PolarDB服务关联角色的具体步骤如下：

1. 前往RAM控制台的角色列表。

2. 检查角色列表中，是否已存在名为AliyunServiceRoleForPolarDB的服务关联角色，如下：

   

3. 若已存在，则进行步骤一：从RDS同步；若不存在，则需创建相关角色。

4. 单击左侧创建角色。

5. 在弹出的创建角色对话框中，选择阿里云服务，并单击下一步。

   

6. 选择角色类型为服务关联角色，并选择云服务为云数据库PolarDB。

   

7. 单击完成，返回角色列表，确保已创建成功。

删除源RDS实例中多余系统账号（仅限逻辑迁移）

为了兼容RDS MySQL和PolarDB两者的系统账号体系，避免迁移后目标PolarDB的系统账号被覆盖，源RDS实例中不允许同时存在root和aliyun_root账号。因此，在进行迁移升级前，请先删除源RDS实例中多余的系统账号。

RDS MySQL各个版本的正确系统账号名如下：

各个版本除了对应的系统账号之外，其余系统账号均需删除。

以清理RDS MySQL 5.6多余的系统账号为例，具体删除步骤如下：

1. 使用高权限账号连接实例。

2. 找到所有的root和aliyun_root系统账号。

   select * from mysql.user where user in ('root', 'aliyun_root');

3. 删除多余的系统账号。RDS MySQL 5.6正确的系统账号是root，因此需要删除aliyun_root账号。

   delete from mysql.user where user = 'aliyun_root' limit n; 

步骤一：从RDS同步

本操作将创建一个与源RDS实例数据相同的PolarDB集群，源RDS实例的增量数据会实时同步到该PolarDB集群。

1. 登录PolarDB控制台，单击创建新集群，进入PolarDB购买页。

2. 选择计费类型为包年包月、按量付费或Serverless。

   • 包年包月：在创建集群时支付计算节点的费用，而存储空间会根据实际数据量按小时计费，并从账户中按小时扣除。

   • 按量付费：无需预先支付费用，计算节点和存储空间（根据实际数据量）均按小时计费，并从账户中按小时扣除。

   • Serverless：无需预先支付费用，计算节点、存储空间、数据库代理等资源在集群使用过程中基于实际需求动态弹性扩缩，并根据扩缩的实际用量来计费。

3. 设置如下参数。

   说明

   下表格中未详细介绍的参数，请参考购买集群相关章节。

   参数	说明
   创建方式	选择从RDS迁移。 说明 在正式迁移切换前PolarDB的读写状态为只读，且默认开启Binlog。迁移完成后，若原RDS为包年包月实例，可申请转单优惠退款。
   地域	选择源RDS MySQL实例所在地域。 说明 新建的PolarDB集群也在此地域。
   源RDS引擎	源RDS实例的引擎类型，固定为MySQL，不可变更。
   源RDS版本	源RDS实例的版本。您可以选择5.6、5.7或8.0。
   源RDS实例	选择源RDS实例，不包括只读实例。
   兼容性	目标PolarDB集群的数据库引擎版本。您可以选择与源RDS实例一致的版本，也可以选择跨版本。
   节点规格	按需选择，建议不低于源RDS实例规格。关于PolarDB节点规格，详情请参见企业版计算节点规格。
   存储引擎	PolarDB支持InnoDB和InnoDB & 高压缩引擎两种引擎类型。 InnoDB：InnoDB引擎。 InnoDB & 高压缩引擎：：InnoDB和X-Engine混合部署引擎。选择该选项后，可以设置高压缩引擎的比例。关于高压缩引擎的更多信息，请参见高压缩引擎（X-Engine）介绍。

4. 在右上角检查集群配置信息，设置购买时长（针对包年包月集群）、购买数量和是否自动续费。

5. 阅读并勾选服务协议。单击立即购买。

6. 在支付页面，确认未支付订单信息和支付方式，单击订购。

   说明

   • 支付成功后，需要等待10~15分钟创建集群，之后您就可以在集群列表中看到新创建的集群。

   • 当集群中的节点状态为创建中时，整个集群可能仍未创建完成，此时集群不可用。只有当集群状态为运行中时，集群才可以正常使用。

   • 请确认已选中正确的地域，否则无法看到您创建的集群。

7. 集群创建成功后，登录PolarDB控制台，单击集群ID进入集群基本信息页。

8. 在基本信息页的RDS迁移功能中，确认目标PolarDB集群的复制延迟小于60秒即可进行步骤二：迁移切换操作。

   

   说明

   • 集群创建后开始从RDS实例同步数据，您需要在30天内进行步骤四：完成迁移操作，超过30天将自动关闭迁移功能。

   • 若为逻辑迁移（DTS数据同步）方式，在PolarDB集群创建完成后，若RDS迁移状态变为预检查失败，请根据错误信息中的提示进行处理。

     例如，如果源RDS中创建了触发器，则预检查会失败并报错“RDS实例存在触发器”。请先删除源RDS的触发器，再点击继续迁移，或者点击放弃迁移后手动去DTS控制台页面创建迁移任务。具体可参见源库存在触发器时如何配置同步或迁移作业。

   • 您可以在此步骤选择放弃迁移，相关影响请参见常见问题。

步骤二：迁移切换

当目标PolarDB集群的复制延迟小于60秒时，即可进行迁移切换操作。

1. 进入PolarDB控制台。

2. 找到目标集群，单击集群的ID。

3. 在基本信息页面的RDS迁移功能中，单击迁移切换。

   

   说明

   • 切换过程一般小于5分钟。

   • 本操作将交换源RDS实例和目标PolarDB集群的读写状态（即将源RDS实例修改为只读，将PolarDB集群修改为可读可写），同时会更换复制方向（即将PolarDB集群的新增数据同步到RDS实例）。

4. 单击确定继续进行迁移切换，单击取消返回检查非升级DTS任务。

   

5. 在切换业务到新数据库对话框中，选择带地址切换（应用程序不用改连接配置）或不带地址切换（应用程序需要改为新的PolarDB连接配置）。

   

   • 若您选择带地址切换（应用程序不用改连接配置），操作步骤如下：

     1. 选中带地址切换（应用程序不用改连接配置）。系统会自动交换源RDS实例和目标PolarDB上的连接地址，您无需在应用程序端修改任何配置即可自动连接到目标PolarDB集群。

        重要

        • 选择带地址切换（应用程序不用改连接配置）前，请务必阅读带地址切换注意事项。

        • 如果待升级的RDS MySQL实例集群是已有数据传输服务（DTS）的源集群或目标集群，则升级后需要将该DTS任务的源或目标集群修改为升级后的PolarDB集群。如数据同步任务、数据迁移任务以及数据订阅任务等。具体请参见修改DTS任务对象。

     2. 单击确定。

   • 若您选择不带地址切换（应用程序需要改为新的PolarDB连接配置），操作步骤如下：

     1. 勾选不带地址切换（应用程序需要改为新的PolarDB连接配置）。

     2. 单击确定。

     3. 刷新页面，当目标PolarDB读写状态显示为读写后，尽快修改应用中的数据库连接地址。

   说明

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

步骤三：源实例DTS任务切换（可选）

1. 进入PolarDB控制台。

2. 找到目标集群，单击集群的ID。

3. 在基本信息页面的RDS迁移功能中，单击源实例DTS任务切换。

   

4. 在切换业务DTS数据库对话框中，选择源实例DTS任务（正向切换）或目标实例DTS任务（切换回滚）。

   重要

   切换前，请先检查源实例和目标实例同步数据的DTS状态，详细DTS状态查询，请参见DTS状态查询。

   

   • 若您选择源实例DTS任务（正向切换），操作步骤如下：

     1. 请选择您需要迁移切换数据库实例的DTS任务。

     2. 单击提交正向切换。

   • 若您选择目标实例DTS任务（切换回滚），操作步骤如下：

     

     1. 请选择您需要迁移切换数据库实例的DTS任务。

     2. 单击提交切换回滚。

步骤四：完成迁移

1. 登录PolarDB控制台。

2. 找到目标集群，单击集群的ID。

3. 在基本信息页面的RDS迁移功能中，单击完成迁移，在弹出的对话框中单击确定。

   说明

   • 单击确定后，系统将在约2分钟内中断同步关系，期间迁移状态将显示为关闭同步，请耐心等待迁移完成。

   • 您可以在完成迁移对话框内选择是否关闭PolarDB集群的Binlog。关闭Binlog会带来少量的写入性能提升，但关闭Binlog后PolarDB集群会自动重启使新配置生效。

   • 如果不再需要源RDS实例，可以手动退订或释放。详情请参见退订或释放RDS实例（可选）。

   • 若您需要为源RDS实例进行续费或变配等操作，请先单击完成迁移。

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

当数据从RDS迁移到PolarDB后，若业务已在PolarDB上稳定运行且不再需要源RDS时，可以退订或释放源RDS实例。

• 对于包年包月的RDS实例，您可以申请转单优惠退款，避免浪费闲置的RDS资源，详情请参见包年包月RDS迁移至PolarDB后申请转单优惠退款。

• 对于按量付费的RDS实例，请及时手动释放实例，以避免浪费闲置的RDS资源。具体可参见释放实例。

查看数据同步任务详情（仅限逻辑迁移）（可选）

在使用逻辑迁移（DTS数据同步）方式进行一键升级的过程中，若遇到迁移报错（如预检查失败）或者其他异常状态（如复制延迟异常高）时，您可以前往对应的DTS数据同步任务的详情页，查看数据同步任务的具体信息。

1. 进入PolarDB控制台。

2. 找到目标集群，单击集群ID。

3. 在基本信息页面的RDS迁移功能中，单击DTS数据同步任务的任务名称，进入DTS控制台数据同步列表。

   

4. 找到对应的数据同步任务，您可查看预检查失败详情、查看同步任务详情、查看同步任务日志等。

   

5. 迁移过程中，若需求调整同步任务的同步对象（如源RDS端有新增库时，需要将新增库也纳入同步对象），您可单击修改同步对象重新配置。