全部产品
Search
文档中心

云原生数据库 PolarDB:升级步骤

更新时间:Oct 17, 2024

本章节介绍了一键升级RDS MySQL至PolarDB的升级步骤。

前置检查

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

说明

若您已完成迁移评估并且无相关异常,可跳过该前置检查。

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

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

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

    ram

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

  4. 单击左侧创建角色

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

    阿里云服务

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

    服务关联角色

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

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

说明

若您已完成迁移评估并且无相关异常,可跳过该前置检查。

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

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

RDS MySQL版本

正确的系统账号名

RDS MySQL 5.6

root

RDS MySQL 5.7

aliyun_root

RDS MySQL 8.0

aliyun_root

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

说明

账号可能是用户创建的,也可能是系统创建并因版本升级而遗留的,某些场景下不会在控制台显示。

以清理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 MySQL实例所在地域。

    说明

    新建的PolarDB集群也在此地域。

    源RDS引擎

    源RDS实例的引擎类型,固定为MySQL,不可变更。

    源RDS版本

    源RDS实例的版本。您可以选择5.65.78.0

    源RDS实例

    选择源RDS实例,不包括只读实例。

    兼容性

    目标PolarDB集群的数据库引擎版本。您可以选择与源RDS实例一致的版本,也可以选择跨版本。

    节点规格

    按需选择,建议不低于源RDS实例规格。关于PolarDB节点规格,详情请参见企业版计算节点规格

    存储引擎

    PolarDB支持InnoDBInnoDB & 高压缩引擎两种引擎类型。

    • 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迁移功能中,单击迁移切换

    image

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

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

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

    image

  5. 切换业务到新数据库对话框中,选择带地址切换(应用程序不用改连接配置)不带地址切换(应用程序需要改为新的PolarDB连接配置)

    image

    • 若您选择带地址切换(应用程序不用改连接配置),操作步骤如下:

      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任务切换

    image

  4. 切换业务DTS数据库对话框中,选择源实例DTS任务(正向切换)目标实例DTS任务(切换回滚)

    重要

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

    image

    • 若您选择源实例DTS任务(正向切换),操作步骤如下:

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

      2. 单击提交正向切换

    • 若您选择目标实例DTS任务(切换回滚),操作步骤如下:

      image

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

      2. 单击提交切换回滚

说明
  • 源实例DTS任务(正向切换)适用迁移切换后将源实例的DTS任务切换到目标实例,在迁移切换后,完成迁移前的DTS任务操作。

  • 目标实例DTS任务(切换回滚)适用于切换回滚后将目标实例的DTS任务切换回源实例,在切换回滚后,取消迁移前操作。

步骤四:完成迁移

在完成步骤一:从RDS同步后,您需要在30天内进行完成迁移操作。

警告
  • 请确保在进行完成迁移操作前,数据迁移已完成,并且后续不再使用数据同步。物理迁移方式下,会中断源RDS到PolarDB集群的数据复制;逻辑迁移方式下,将会删除数据同步任务。

  • 由于本操作将中断PolarDB集群和RDS实例间的数据同步,不再提供取消迁移(可选)功能,建议您使用一段时间PolarDB集群,确认正常后再执行本操作。

  1. 登录PolarDB控制台

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

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

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

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

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

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

退订或释放RDS实例(可选)

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

  • 对于包年包月的RDS实例,您可以进行退订。详情请参见退订包年包月主实例

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

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

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

  1. 进入PolarDB控制台

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

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

    DTS任务

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

    任务详情

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

    修改同步对象