文档中心

云数据库 MySQL 版

升级版本

升级实例数据库大版本

云数据库 MySQL 版提供了升级实例大版本的功能，支持将满足条件的 MySQL 5.7 实例升级至 MySQL 8.0。本文介绍升级实例大版本的详细步骤。

背景信息

云数据库 MySQL 版提供的升级实例大版本的功能，可以将满足条件的 MySQL 5.7 实例升级至 MySQL 8.0。升级实例大版本支持立即、可维护时间段或指定时间段进行。云数据库 MySQL 版也为升级提供了观测能力，对满足条件的实例提供临时只读终端，供测试验证。云数据库 MySQL 版会为实例创建临时只读终端，您可通过临时只读终端进行大版本升级的业务影响验证。如验证通过，可在任务中心继续升级任务；如验证不符合预期，还可以选择取消升级，对实例进行回滚。

在升级期间，您仍可正常进行读写操作，业务写入的数据会继续写入 MySQL 5.7 实例。待 MySQL 5.7 实例中的全量数据（即升级前已有的数据）迁移完成后，系统会继续同步增量 Binlog（即升级期间产生的增量数据），在目标实例数据追齐后执行切换操作。

为实例发起大版本升级任务后，可在任务中心中查看到实例升级的具体进度。实例大版本升级任务包含以下七个阶段。在完成任务初始化、资源处理、数据处理、数据追齐等阶段后，实例会在切换阶段切换到目标版本，此时任务将进入“等待任务继续”阶段（此时任务状态为“等待执行”），实例状态将保持为"升级中"。在此期间，您可选择“取消”以回退到升级前状态，或选择“立即执行”以完成升级。“等待任务继续”阶段的持续时长即设定的观测时长，如果“等待执行”阶段持续时间超过观测时长，系统则会自动完成升级。

说明

“等待可切换时间”阶段和“任务继续”阶段仅在选择可维护时间段或指定时间段升级时存在。

在“等待可切换时间”阶段，您可以使用临时域名（即临时终端的域名，临时终端会带有临时标签）连接到待切换的后台实例进行只读测试，用户名和密码与当前实例一致，完成切换后临时域名将自动移除。

注意事项

升级切换阶段将存在秒级闪断，建议选择在可维护时间段或业务低峰期切换、增加应用的重连机制、可以大幅降低数据库连接闪断对业务的影响。

在升级过程中，不要进行创建账号、删表或 DDL 操作。以上操作可能会导致复制链路异常，进而导致升级失败。

升级数据库实例大版本时，会为实例创建一个临时只读终端，供测试验证。如实例在升级前开启了数据库代理，在升级过程中会为实例创建一个临时的只读代理终端和一个临时的只读直连终端；如实例未开启数据库代理功能，在升级过程中则只为实例创建一个临时的只读直连终端。关于查看连接终端的详细信息，请参见查看连接终端。

说明

在实例的终端列表中，临时终端的终端名/ID 列会带有临时标签。

在进入等待任务继续阶段前，后端已经完成了升级所需的准备工作并进行了流量的切换。如果此时在实例中应用了 MySQL 8.0 的特有功能，则会导致取消升级任务失败。

暂不支持升级使用了 RocksDB 引擎的实例的数据库大版本。

不建议在升级期间执行 DDL 语句，以免因版本不同导致主从复制中断。

实例数据库大版本升级完成后，若超出设置的观测时长，不再支持回退至升级前原版本，也不支持降级至更低数据库版本。

规则与限制

仅支持将 MySQL 5.7 实例升级至 MySQL 8.0，不支持将 MySQL 5.7 或 MySQL 8.0 实例升级至 MySQL 8.4。

升级实例时需确保实例的状态为运行中。

如实例有灾备实例，需要先删除灾备实例，升级主实例后重建灾备实例。

执行升级前，云数据库 MySQL 版会对目标实例进行预检查。预检查的检查项包含了 MySQL 原生的 Upgrade Checker Utility 的检查项和云数据库 MySQL 版自定义的检查项。检查项的结果分为失败、警告和注意三种，如存在失败的检查项，则不能升级实例；如存在警告或注意的检查项，则需您修复后重新发起预检查，或忽略该检查后才能升级实例。关于预检查项的详细信息，请参见检查项列表。

操作步骤

登录云数据库 MySQL 版控制台。

在顶部菜单栏选择实例所属的项目和地域。

说明

如未设置实例的所属项目，本操作应选择项目为账号全部资源。

在实例列表页面，单击目标实例名称。

在实例信息页签下，将鼠标指向配置信息区域数据库版本右侧的升级版本，在弹窗中单击升级大版本。

在大版本升级页面，修改或确认以下配置后，单击升级预检查。

参数	说明
实例 ID/名称	确认待升级大版本的实例的名称和 ID。
实例类型	确认待升级大版本的实例的类型。
数据校验延迟阈值	设置数据同步过程中的数据校验延迟阈值。可设置为 1~10 之间的整数。延迟阈值设置越小，完成升级所需的时间可能越长。
目标数据库版本	确认升级的目标版本，当前仅支持为 MySQL 8.0.32。
节点规格	确认待升级大版本的实例的节点规格。
风险确认	确认并勾选升级实例大版本的可能风险。

说明

预检查所需时间取决于实例的库表数量。如实例下的库表数量较多，可能需要较多时间以完成预检查。关闭或刷新页面不会中断预检查的进行，后台会持续进行。您可稍后重新进入预检查页面或在任务中心查看预检查的完成情况。

完成预检查后，您需要在大版本升级页面中完成以下配置并单击开始升级。

参数	说明
查看并确认预检查结果	完成预检查后，在大版本升级页面展示了未能通过或需要关注的检查项。您可单击检查项列表中操作列的详情，获取可能存在的问题、影响及修复方案。单击检查项列表顶部的忽略全部忽略全部问题；或在检查项列表中单击操作列的忽略，逐项忽略问题。说明如检查项未通过，会根据影响程度被标记为错误、警告或注意。对于“错误”的检查项，是必须解决或修复的问题，在解决之前，不可继续升级流程；对于“警告”和“注意”的检查项，可根据自身需求进行修复或忽略。在忽略之前，不可继续升级流程。可单击检查项列表顶部的下载 MySQL Upgrade Utility 日志，获取 MySQL Upgrade Utility 的升级日志。
升级切换时间	选择升级切换时间。可选择立即执行、指定时间段或可维护时间段。立即执行：提交升级订单后，立即执行。指定时间段：在指定的时间段内进行变配。可维护时间段：在为实例设定的可维护时间段内执行。可在实例信息页查看当前为实例设置的可维护时间段，如需调整，请参见设置可维护时间段。
指定时间段	如选择在指定时间段内进行升级，则需要设定升级的时间段。说明不支持跨天设置时间段。时间段最短为两小时。请在控制台提示的时间范围内进行时间段的设定。
可维护时间段	如选择在可维护时间段内进行升级，则需要确认实例的可维护时间段。说明可单击编辑修改实例的可维护时间段。关于可维护时间段的详细设置规则，请参见设置可维护时间段。任务发起后，仍然可以修改实例的可维护时间段，但已发起的任务的执行时间不会随着可维护时间段的修改自动调整。如需调整任务的执行时间，需手动在任务中心进行安排和调整。更多详细信息，请参见修改任务执行时间。
观测时长	设定实例升级后的观测时长。支持将设置为 1~72 之间的整数值，单位为小时。

说明

开始升级后，大版本升级页面将会关闭，实例状态会切换为升级中，您可在任务中心查看升级任务的详细进展。

如选择在可维护时间段或指定时间段进行升级，实例的升级任务会有等待可切换时间阶段。在此阶段内，您可以：

通过临时只读终端进行大版本升级的业务影响验证。

在任务中心，选择立即执行升级任务、修改任务的切换时间或取消任务。

实例切换到目标版本后，任务将进入到等待执行阶段，实例状态将保持为升级中，自此实例将进入观测阶段。在此期间，您可在任务中心选择取消任务回退到升级前或选择立即执行完成升级。若等待执行阶段持续时间超过设定的观测时长，系统将自动完成升级。

最近更新时间：2026.10.09 18:07:11

这个页面对您有帮助吗？

有用

无用