本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。
本章节介绍了一键升级RDS MySQL至PolarDB的升级步骤。
前置检查
检查是否已创建PolarDB服务关联角色(仅限逻辑迁移)
若您已完成迁移评估并且无相关异常,可跳过该前置检查。
在使用逻辑迁移(DTS数据同步)方式进行一键升级前,请先检查是否已创建PolarDB服务关联角色,以及是否已授予DTS访问云资源的权限。检查是否已创建PolarDB服务关联角色的具体步骤如下:
前往RAM控制台的角色列表。
检查角色列表中,是否已存在名为AliyunServiceRoleForPolarDB的服务关联角色,如下:
若已存在,则进行步骤一:从RDS同步;若不存在,则需创建相关角色。
单击左侧创建角色。
在弹出的创建角色对话框中,选择阿里云服务,并单击下一步。
选择角色类型为服务关联角色,并选择云服务为云数据库PolarDB。
单击完成,返回角色列表,确保已创建成功。
删除源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多余的系统账号为例,具体删除步骤如下:
使用高权限账号连接实例。
找到所有的root和aliyun_root系统账号。
select * from mysql.user where user in ('root', 'aliyun_root');
删除多余的系统账号。RDS MySQL 5.6正确的系统账号是root,因此需要删除aliyun_root账号。
delete from mysql.user where user = 'aliyun_root' limit n;
白名单检查(可选)
如果源RDS主实例和只读实例的白名单配置不一致,为了保证只读节点的白名单自动同步到目标PolarDB集群,请提前将只读节点的白名单合入到主节点的白名单配置中。
步骤一:从RDS同步
本操作将创建一个与源RDS实例数据相同的PolarDB集群,源RDS实例的增量数据会实时同步到该PolarDB集群。
登录PolarDB控制台,单击创建新集群,进入PolarDB购买页。
选择计费类型为包年包月、按量付费或Serverless。
包年包月:在创建集群时支付计算节点的费用,而存储空间会根据实际数据量按小时计费,并从账户中按小时扣除。
按量付费:无需预先支付费用,计算节点和存储空间(根据实际数据量)均按小时计费,并从账户中按小时扣除。
Serverless:无需预先支付费用,计算节点、存储空间、数据库代理等资源在集群使用过程中基于实际需求动态弹性扩缩,并根据扩缩的实际用量来计费。
设置如下参数。
说明下表格中未详细介绍的参数,请参考购买集群相关章节。
参数
说明
创建方式
选择从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)介绍。
在右上角检查集群配置信息,设置购买时长(针对包年包月集群)、购买数量和是否自动续费。
阅读并勾选服务协议。单击立即购买。
在支付页面,确认未支付订单信息和支付方式,单击订购。
说明支付成功后,需要等待10~15分钟创建集群,之后您就可以在集群列表中看到新创建的集群。
当集群中的节点状态为创建中时,整个集群可能仍未创建完成,此时集群不可用。只有当集群状态为运行中时,集群才可以正常使用。
请确认已选中正确的地域,否则无法看到您创建的集群。
集群创建成功后,登录PolarDB控制台,单击集群ID进入集群基本信息页。
在基本信息页的RDS迁移功能中,确认目标PolarDB集群的复制延迟小于60秒即可进行步骤三:迁移切换操作。
说明已存在DTS双向同步的实例无法进行一键迁移/升级,可能会出现数据不一致问题;
集群创建后开始从RDS实例同步数据,您需要在30天内进行步骤五:完成迁移操作,超过30天将自动关闭迁移功能。
若为逻辑迁移(DTS数据同步)方式,在PolarDB集群创建完成后,若RDS迁移状态变为预检查失败,请根据错误信息中的提示进行处理。
例如,如果源RDS中创建了触发器,则预检查会失败并报错“RDS实例存在触发器”。请先删除源RDS的触发器,再点击继续迁移,或者点击放弃迁移后手动去DTS控制台页面创建迁移任务。具体可参见源库存在触发器时如何配置同步或迁移作业。
您可以在此步骤选择放弃迁移,相关影响请参见常见问题。
步骤二:地址补齐(可选)
PolarDB一键迁移支持带地址切换,您可保留数据库原连接地址,无需应用程序修改任何连接配置即可切换至PolarDB。需要注意,仅当源RDS和目标PolarDB集群同时存在的连接地址才支持相互切换,默认情况下目标端仅创建私网主地址和私网集群地址,如果源端包含2个以上的连接地址,您需在切换前在目标端创建好对应的连接地址,否则不会切换。关于如何为PolarDB集群和RDS实例创建连接地址,请参见管理连接地址和设置连接地址。
在目标端集群变成运行中后,才可进行地址补齐操作。此外您还可以根据业务需要,进行地址属性配置、实例参数配置、只读节点补齐等操作。
使用带地址切换交换私网地址前,请确保源RDS实例和目标端PolarDB集群属于同一个VPC,否则切换后原有服务将无法连接。
步骤三:迁移切换
当目标PolarDB集群的复制延迟小于60秒时,即可进行迁移切换操作。
进入PolarDB控制台。
找到目标集群,单击集群的ID。
在基本信息页面的RDS迁移功能中,单击迁移切换。
说明切换过程一般小于5分钟。
本操作将交换源RDS实例和目标PolarDB集群的读写状态(即将源RDS实例修改为只读,将PolarDB集群修改为可读可写),同时会更换复制方向(即将PolarDB集群的新增数据同步到RDS实例)。
单击确定继续进行迁移切换,单击取消返回检查非升级DTS任务。
在切换业务到新数据库对话框中,选择带地址切换(应用程序不用改连接配置)或不带地址切换(应用程序需要改为新的PolarDB连接配置)。
若您选择带地址切换(应用程序不用改连接配置),操作步骤如下:
选中带地址切换(应用程序不用改连接配置)。系统会自动交换源RDS实例和目标PolarDB上的连接地址,您无需在应用程序端修改任何配置即可自动连接到目标PolarDB集群。
单击确定。
若您选择不带地址切换(应用程序需要改为新的PolarDB连接配置),操作步骤如下:
勾选不带地址切换(应用程序需要改为新的PolarDB连接配置)。
单击确定。
刷新页面,当目标PolarDB读写状态显示为读写后,尽快修改应用中的数据库连接地址。
步骤四:源实例DTS任务切换(可选)
若源实例存在关联的DTS链路(非一键迁移DTS链路),您可使用此功能修改(替换)DTS同步或迁移任务的源或目标库实例,平滑切换关联业务,实现原理和注意事项请参见修改DTS任务的源或目标库实例。
在库表结构迁移和全量迁移阶段,请勿执行库或表结构变更的DDL操作,否则数据迁移任务会失败。
进入PolarDB控制台。
找到目标集群,单击集群的ID。
在基本信息页面的RDS迁移功能中,单击源实例DTS任务切换。
在切换业务DTS数据库对话框中,选择源实例DTS任务(正向切换)或目标实例DTS任务(切换回滚)。
重要切换前,请先检查源实例和目标实例同步数据的DTS状态,详细DTS状态查询,请参见DTS状态查询。
若您选择源实例DTS任务(正向切换),操作步骤如下:
请选择您需要迁移切换数据库实例的DTS任务。
单击提交正向切换。
若您选择目标实例DTS任务(切换回滚),操作步骤如下:
请选择您需要迁移切换数据库实例的DTS任务。
单击提交切换回滚。
源实例DTS任务(正向切换)适用迁移切换后将源实例的DTS任务切换到目标实例,在迁移切换后,完成迁移前的DTS任务操作。
目标实例DTS任务(切换回滚)适用于切换回滚后将目标实例的DTS任务切换回源实例,在切换回滚后,取消迁移前操作。
步骤五:完成迁移
在完成步骤一:从RDS同步后,您需要在30天内进行完成迁移操作。
请确保在进行完成迁移操作前,数据迁移已完成,并且后续不再使用数据同步。物理迁移方式下,会中断源RDS到PolarDB集群的数据复制;逻辑迁移方式下,将会删除数据同步任务。
由于本操作将中断PolarDB集群和RDS实例间的数据同步,不再提供取消迁移(可选)功能,建议您使用一段时间PolarDB集群,确认正常后再执行本操作。
登录PolarDB控制台。
找到目标集群,单击集群的ID。
在基本信息页面的RDS迁移功能中,单击完成迁移,在弹出的对话框中单击确定。
说明单击确定后,系统将在约2分钟内中断同步关系,期间迁移状态将显示为关闭同步,请耐心等待迁移完成。
您可以在完成迁移对话框内选择是否关闭PolarDB集群的Binlog。关闭Binlog会带来少量的写入性能提升,但关闭Binlog后PolarDB集群会自动重启使新配置生效。
如果不再需要源RDS实例,可以手动退订或释放。详情请参见退订或释放RDS实例(可选)。
若您需要为源RDS实例进行续费或变配等操作,请先单击完成迁移。
退订或释放RDS实例(可选)
当数据从RDS迁移到PolarDB后,若业务已在PolarDB上稳定运行且不再需要源RDS时,可以退订或释放源RDS实例。
对于包年包月的RDS实例,您可以申请转单优惠退款,避免浪费闲置的RDS资源,详情请参见包年包月RDS迁移至PolarDB后申请转单优惠退款。
对于按量付费的RDS实例,请及时手动释放实例,以避免浪费闲置的RDS资源。具体可参见释放实例。
查看数据同步任务详情(仅限逻辑迁移)(可选)
在使用逻辑迁移(DTS数据同步)方式进行一键升级的过程中,若遇到迁移报错(如预检查失败)或者其他异常状态(如复制延迟异常高)时,您可以前往对应的DTS数据同步任务的详情页,查看数据同步任务的具体信息。
进入PolarDB控制台。
找到目标集群,单击集群ID。
在基本信息页面的RDS迁移功能中,单击DTS数据同步任务的任务名称,进入DTS控制台数据同步列表。
找到对应的数据同步任务,您可查看预检查失败详情、查看同步任务详情、查看同步任务日志等。
迁移过程中,若需求调整同步任务的同步对象(如源RDS端有新增库时,需要将新增库也纳入同步对象),您可单击修改同步对象重新配置。