文档首页/ 云数据库 RDS_云数据库 RDS for MySQL/ 用户指南/ 版本升级/ RDS for MySQL 5.7版本升级到8.0
更新时间：2025-09-04 GMT+08:00
查看PDF
分享

RDS for MySQL 5.7版本升级到8.0

操作场景

用户可以将RDS for MySQL 5.7版本实例升级到最新8.0版本，体验更丰富的版本能力。

升级方案

大版本升级过程中会创建一个高版本的目标实例，然后将源实例数据同步到目标实例，再切换VIP，完成整个升级流程。

云数据库 RDS for MySQL支持通过以下两种方式升级实例大版本：

升级须知

表1 升级须知

阶段

注意事项

功能限制

升级前
  • 建议您将原实例数据恢复到新实例上面，先使用新实例进行升级测试，确认各项功能正常后再升级原实例。
  • 下发RDS for MySQL 5.7升级至8.0前，需进行预检查，请注意以下内容：
    • 预检查耗时与表数量相关，请您尽量在业务低峰期执行。
    • 检查报告保留24小时，请及时下载。
    • “检查参数”项失败时，请根据检查详情中的检查项，对照表3进行修复，级别为error的检查项，必须修复才可升级，级别为warning的检查项，请知悉升级前后该内核特性的变化。
    • 修复后需单击“重新检查”，获取新的检查结果。
  • 只能从5.7的最新小版本升级到8.0的最新小版本。请先确认5.7版本已经是最新小版本，才能继续大版本升级。
  • 大版本升级操作建议避开执行备份的时间窗。
  • 升级大版本前建议先做一次全量备份。
  • 升级到8.0版本后，主实例和只读实例会共用SQL限流规则，为避免主实例SQL限流规则对只读业务造成影响，请在升级前审视调整主实例SQL限流规则、以及主实例和只读实例的SQL限流开关。
  • 大版本升级操作会将实例升级到目标实例新的内核大版本，并且不支持降级。有关内核版本详情，请参见内核版本说明。
  • 以下场景不支持RDS for MySQL 5.7升级至8.0：
    • 不支持已绑定DDM或已开通数据库代理的RDS for MySQL实例进行升级。
    • 默认不支持单机、本地盘、集群版实例进行升级。单机实例大版本升级在预检查阶段会对实例产生一定的性能影响，如需开通，请提交工单申请。
    • 主实例下的只读实例带有SQL限流规则时，不支持升级，请在升级前删除只读的限流规则。
  • 对于主备实例，复制延迟大于300秒无法升级大版本。
  • 实例中存在异常节点，无法升级大版本。
  • 实例中存在DRS任务，无法升级大版本，请在升级前先删除DRS任务。
  • 目前RDS for MySQL实例最大可支持50万张表（系统表+数据表），大于50万张表时，会导致大版本升级失败。
  • 云数据库RDS for MySQL暂不支持已开启事件定时器功能的实例升级大版本，若您想使用该功能，请先关闭事件定时器。具体操作请参考开启或关闭事件定时器。
  • 准备升级时，如果仍存在XA prepared状态的XA事务，需要将这些XA事务commit或者rollback，再进行升级；否则无法升级成功。更多内容请参见常见问题。
  • 如果实例是从5.6升级到5.7，为避免连续升级出现问题，系统默认需要24小时的观察期，建议24小时后再执行5.7升级到8.0的操作。

升级中
  • MySQL大版本升级耗时与实例的数据量和表数量有关，请您尽量在业务低峰期执行。
  • 升级数据库大版本过程将造成约10~120秒的业务中断，请确保您的应用有自动重连机制。请在业务低峰期执行该操作，在业务高峰期执行会导致升级时长变长。
  • 升级主实例大版本时，如有只读实例，也会同步升级只读实例的大版本（不支持单独升级只读实例的大版本）。
  • 大版本升级期间，自动扩容不生效，需要确保实例预留了足够的空间支撑升级过程中的业务写入。
  • 大版本升级过程中禁止event的DDL操作，如create event、drop event和alter event。
  • 大版本升级定时任务需预准备，设置后不可取消。

升级后
  • 请务必仔细对比升级前后版本差异，建议您新建一个RDS for MySQL 5.7或8.0版本实例进行语法测试，避免应用使用的低版本语法或特性在升级高版本后不支持。
  • 大版本升级后，规格参数会恢复到升级版本的默认值，包括以下参数：threadpool_size、innodb_buffer_pool_size、innodb_io_capacity、innodb_io_capacity_max、innodb_buffer_pool_instances、back_log、max_connections。
  • 5.7版本和8.0版本实例存在相同参数取值范围不一样的情况，例如参数“max_execution_time”如果在5.7版本中设置为小于60000，大版本升级后将恢复成默认值0，这是因为8.0版本该参数最小值只能为60000。
  • 升级大版本后，升级前的备份将不可用于新版本实例，时间点恢复功能将不能选择升级前的时间点。

操作步骤

  1. 单击管理控制台左上角的，选择区域。
  2. 单击页面左上角的，选择“数据库 > 云数据库 RDS”，进入RDS信息页面。
  3. 在“实例管理”页面，单击主实例名称。
  4. 在“概览”页面的“数据库引擎版本”处，单击“升级数据库版本”。

    图1 升级数据库大版本

  5. 在弹出框中，确认升级信息，然后单击“下一步”。

    图2 升级信息确认
    • 对于RDS for MySQL 5.7升级至8.0的场景，执行6。
    • 其他升级场景，执行7。

  6. 升级预检查。

    图3 开始预检查

    预检查结束后，根据预检查结果参考表3进行修复。

    修复完成后，单击“重新检查”再次下发检查，直到“检查实例状态”和“检查参数”全部是“已完成”，然后单击“下一步”。

    图4 预检查完成

  7. 选择升级方式，单击“确定”。

    • 立即升级：系统会立即升级您的数据库版本到当前5.7或8.0最新版本。
    • 可维护时间段内升级：系统会在您设置的可维护时间段内，升级您的数据库版本到当前5.7或8.0最新版本。详情请参见设置可维护时间段。
    图5 选择升级方式

    如果升级失败，参考表4进行修复。

RDS for MySQL支持通过DRS将RDS for MySQL 5.7版本数据迁移到8.0版本。使用该方式进行大版本升级，需要提前准备好待迁移到的目标版本数据库实例。

您可以在“实例管理”页面，单击目标实例名称，在页面右上角，单击“迁移数据库”，进入数据复制服务信息页面。

具体迁移操作，请参见《数据复制服务用户指南》的“入云迁移”内容。

表2 MySQL数据库版本信息

源数据库版本

目标数据库版本

迁移类型

RDS for MySQL/自建MySQL/其他云MySQL

  • 5.5.x
  • 5.6.x
  • 5.7.x
  • 8.0.x

RDS for MySQL

  • 5.6.x
  • 5.7.x
  • 8.0.x

MySQL数据库版本升级

DRS仅支持从低版本迁移到高版本。

升级预检查及升级失败的修复建议

表3 预检查项及修复建议

预检查项

检查内容

修复建议

utf8mb3Check

检查字符集utf8mb3。

MySQL 5.7中，字符集utf8等同于utf8mb3, MySQL 8.0中，字符集utf8等同于utf8mb4, 请注意升级后如果使用utf8创建表格，相当于使用字符集utf8mb4。

用户无需处理该项检查。

removedSysVars

检查已移除的系统参数。

系统参数在MySQL 8.0中已删除。

该检查项不影响升级，用户无需处理。

sysVarsNewDefaults

检查系统参数默认值变化。

系统参数在MySQL 8.0中的默认值发生变化，如果您修改过该参数的值，升级后保留修改后的值，如果未修改过，将采用新的默认值。

该检查项不影响升级，用户无需处理。

zeroDatesCheck

检查使用了零日期、日期时间和时间戳。

MySQL 8.0.16及以后版本，将零值日期（例：“2024-00-00”）作为查询条件时，MySQL将该字符串转换为DATE，如果转换失败，该查询将报错。

该检查项不影响升级，但影响升级后的查询逻辑。用户无需处理global.sql_mode的报错，建议排查是否存在此类值，如果存在，修改为非零值。

enumSetElementLenghtCheck

检查ENUM/SET列元素长度。

元素长度大于255个字符，请修改到不超过255个字符。

reservedKeywordsCheck

检查保留字。

与MySQL 8.0中的保留字冲突，请修改名字。

mysqlDollarSignNameCheck

检查$符号。

数据库对象名包含“$”，请修改。

mysqlInvalid57NamesCheck

检查非法库名/表名/列名等。

包含非法名字，请修改。

groupByAscCheck

检查group by ASC/DESC语法。

MySQL 8.0移除了GROUP BY ASC/DESC语法，请修改数据库对象，可将ASC/DESC关键字从 GROUP BY子句中移除，并放置在适当的ORDER BY子句中。

checkTableOutput

通过"check table x for upgrade"检查表存在的问题。

根据检查结果中的“说明”进行修复。

engineMixupCheck

检查 InnoDB 识别了属于其他引擎的表的情况。

表格被 InnoDB引擎识别，但 SQL 层认为它们属于另一个引擎，请提交工单解决。

foreignKeyLengthCheck

检查外键约束名长度。

外键约束名长度不得超过64个字符，请修改。

nonNativePartitioningCheck

检查使用了非本地分区引擎的分区表的情况。

MySQL 8.0仅支持InnoDB 和 NDB作分区表引擎，请转换为InnoDB引擎，或删除其分区。

routinesSyntaxCheck

检查语法不兼容的情况。

存储过程、函数等数据库对象的定义包含了不兼容的语法，例如与MySQL8.0中的保留字冲突，请根据检查结果中的“说明”做修改。

maxdbFlagCheck

检查是否使用了过时的 MAXDB sql_mode标志。

MySQL 8.0删除了sql_mode中的MAXDB选项，请修改sql_mode参数，不使用MAXDB。

sqlModeFlagCheck

检查是否使用了过时的sql_mode标志。

MySQL 8.0删除了部分sql_mode标志，请根据检查结果中的“说明”，修改sql_mode参数。

removedSysLogVars

检查已移除的系统日志系统参数。

MySQL 8.0移除了部分系统日志系统参数，请知悉。

用户无需处理该项检查结果。

mysqlIndexTooLargeCheck

检查索引长度。

MySQL 5.7和MySQL 8.0都支持相同长度的索引，最大索引长度为767字节，在MySQL 8.0 utf8mb4编码下，最大支持191个字符；请修改索引长度至不超过191个字符。

circularDirectoryCheck

检查表空间数据文件路径使用循环目录。

目标版本不支持表空间在数据文件路径中包含循环目录引用（例如“/../”），请提交工单处理。

columnsWhichCannotHaveDefaultsCheck

检查列默认值。

BLOB、TEXT、GEOMETRY或JSON等类型的列不允许设置默认值，请通过ALTER TABLE语句删除默认值。

removedFunctionsCheck

检查已移除的函数。

目标版本删除了部分函数，请根据检查结果中的“说明”，修改相应数据库对象。

mysqlOrphanedRoutinesCheck

检查孤立的存储过程或函数等。

孤立的存储过程或函数等指其引用的数据库对象已不存在，无法运行，请删除。

mysqlEmptyDotTableSyntaxCheck

检查废弃的标识符。

请根据检查结果中的“说明”，修改对应数据库对象中的标识符。

mysqlSchemaCheck

检查表名冲突。

MySQL8.0新增部分表，请通过RENAME TABLE语句修改存在冲突的表名。

mysqlInvalidEngineForeignKeyCheck

检查外键约束指向其他引擎的表。

请通过ALTER TABLE语句修改引擎，或删除外键引用。

lowerCaseNameCheck

检查参数lower_case_table_names=1时，是否存在大写表名

参数lower_case_table_names=1时，如果存在大写表名，将导致升级失败；请先修改lower_case_table_names=0，通过RENAME TABLE语句将检查结果中的大写表名修改为小写，再将lower_case_table_names的值修改回1。

specVarInConfigFileCheck

检查配置文件中 sql_mode、loose_tls_version 是否有过时的值。

目标版本移除了部分sql_mode标志，MySQL8.0.28及其以上，loose_tls_version参数不支持TLSv1和TLSv1.1，请根据检查结果修改sql_mode或loose_tls_version参数的值。

reversedUserCheck

检查是否创建了创建 mysql.infoschema@localhost。

MySQL8.0内置mysql.infoschema@localhost账号，如MySQL5.7存在此账号，将导致升级失败，升级前请删除该账号。

schemaInconsistencyCheck

检查表文件移除或损坏导致的数据库结构不一致问题。

表文件.frm缺失，请提交工单申请处理。

geometryIndexCheck

检查空间坐标作为索引时是否为空间索引。

目标版本中，空间坐标作索引时必须为空间索引，请重建索引或删除索引。

danglingIndexCheck

检查是否存在空悬索引。

全文索引列删除导致FTS_DOC_ID空悬的表，需要进行 OPTIMIZE TABLE修复。

viewColumnCheck

检查视图列名长度。

目标版本中视图列名长度不可超过64个字符，请通过ALTER VIEW语句修改列名。

partitionedTablesInSharedTablespaceCheck

检查分区表是否在共享表空间。

目标版本不支持共享表空间，请通过ALTER TABLE语句将它们移动到独立表空间。

partitionsReferencedCheck

检查分区表是否被普通表通过外键引用。

分区表不可被普通表引用，请删除外键引用。

partitionsRangeDateCheck

检查按时间分区的分区表。

MySQL 8.0按时间分区时，时间列内容要求是标准的格式（例如：'YYYY-MM-DD hh:mm:ss' 或 'YY-MM-DD hh:mm:ss'），并修改相应表中时间数值为标准格式。

预检查通过后，启动升级流程。如果升级失败，请参考表4处理。

表4 升级失败的修复建议

问题描述

影响

修复建议

RDS for MySQL 5.7升级到8.0后，由于默认字符集变更，导致执行部分SQL时索引失效。

5.7默认使用UTF8mb3字符集，8.0默认使用UTF8mb4字符集。

5.7版本使用默认字符集建表，在升级过程中，字符集不会自动变更为8.0版本默认字符集，若用户在内核升级到8.0后建表，同时对两张字符集不同的表进行JOIN等操作，影响SQL执行时索引选择，最终导致SQL执行时间变长。

修改8.0的库、表、字段字符集、以及默认字符集，与5.7的字符集一致。

RDS for MySQL 5.7升级到8.0过程中，删除了全文索引，可能会导致升级失败。

可能会导致升级失败。

执行optimize table重建表；并排查空悬FTS_DOC_ID，详见表3。

RDS for MySQL 5.7升级到8.0过程中，由于含有分区表外键约束（通过参数foreign_key_check设置），导致升级失败。

导致升级失败。

移除该外键约束。

5.7版本中含有definer列为空的“mysql.events”表，会导致RDS for MySQL 5.7升级到8.0失败。

导致升级失败。

将definer列设置为非空。

RDS for MySQL 5.7升级到8.0过程中，Server层和InnoDB层列名大小写不匹配导致升级失败。

导致升级失败。

执行optimize table重建表。

RDS for MySQL 5.7升级到8.0过程中，索引中包含的字段在Server层和InnoDB层中大小写不一致导致升级失败。

导致升级失败。

执行optimize table重建表。

使用8.0不支持的“BTREE SPATIAL INDEX”，会导致RDS for MySQL 5.7升级到8.0失败。

导致升级失败。

删除“BTREE SPATIAL INDEX”索引。

常见问题

如何查看RDS实例的版本号？

  • 通过RDS实例管理页面，查看数据库实例的版本号。
    图6 实例管理
  • 通过DAS页面，查看数据库实例的版本号。
    1. 在DAS页面，登录目标实例。
    2. 在界面上方选择“SQL操作 > SQL查询”。
    3. 执行select @@version;语句，查看该实例的版本号。

准备升级时，如果仍存在XA prepared状态的XA事务怎么办？

  • 请使用 XA recover; 语句排查后，将这些XA事务commit或者rollback，再进行升级；否则无法升级成功。
    • XA recover语句只会显示XA prepare状态后的XA事务，其他阶段如XA start、XA end、XA commit、XA rollback后的XA事务都不会显示在其中。
    • 如果要commit或者rollback处于XA prepare状态的XA事务，请在XA recover返回的结果中，找到data一列（如图7中的'xid1'），作为XA commit或者XA rollback的输入。
    图7 排查XA事务
父主题： 版本升级

相关文档