RDS for MySQL 5.7版本升级到8.0

操作场景

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

通过RDS界面升级大版本：关于内核版本的功能，请参见华为云RDS for MySQL内核版本说明。
如需通过界面升级大版本，您可以在管理控制台右上角，选择“工单 > 新建工单”，提交权限申请。
通过DRS升级大版本：通过DRS迁移功能将RDS for MySQL低版本实例迁移到高版本。

注意事项

下发RDS for MySQL 5.7升级至8.0前，需进行预检查，请注意以下内容：
- 预检查耗时与表数量相关，请您尽量在业务低峰期执行。
- 检查报告保留24小时，请及时下载。
- “检查参数”项失败时，请根据检查详情中的检查项，对照表1进行修复，级别为error的检查项，必须修复才可升级，级别为warning的检查项，请知悉升级前后该内核特性的变化。
- 修复后需单击“重新检查”，获取新的检查结果。
只能从5.7的最新小版本升级到8.0的最新小版本。请先确认5.7版本已经是最新小版本，才能继续大版本升级。
大版本升级操作建议避开执行备份的时间窗。
升级大版本前建议先做一次全量备份。
升级数据库大版本过程将造成约10~120秒的业务中断，请确保您的应用有自动重连机制。请在业务低峰期执行该操作，在业务高峰期执行会导致升级时长变长。
升级主实例大版本时，如有只读实例，也会同步升级只读实例的大版本（不支持单独升级只读实例的大版本）。
升级大版本后，实例会升级到新的内核大版本，不支持降级。
请务必仔细对比升级前后版本差异，建议您新建一个RDS for MySQL 5.7或8.0版本实例进行语法测试，避免应用使用的低版本语法或特性在升级高版本后不支持。
建议您将原实例数据恢复到新实例上面，先使用新实例进行升级测试，确认各项功能正常后再升级原实例。
内核大版本升级期间，自动扩容不生效，需要确保实例预留了足够的空间支撑升级过程中的业务写入。
大版本升级定时任务需预准备，设置后不可取消。
升级大版本后，升级前的备份将不可用于新版本实例，时间点恢复功能将不能选择升级前的时间点。
大版本升级过程中禁止event的DDL操作，如create event、drop event和alter event。
大版本升级后，规格参数会恢复到升级版本的默认值，包括以下参数：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。

约束限制

有关内核版本详情，请参见内核版本说明。
对于主备实例，复制延迟大于300秒无法升级大版本。
实例中存在异常节点，无法升级大版本。
MySQL 5.7及之后版本不再支持Sequence Engine，升级前请确认。
目前RDS for MySQL实例最大可支持50万张表（系统表+数据表），大于50万张表时，会导致大版本升级失败。
云数据库RDS for MySQL暂不支持已开启事件定时器功能的实例升级大版本，若您想使用该功能，请先关闭事件定时器。具体操作请参考开启或关闭事件定时器。
升级到8.0版本后，主实例和只读实例会共用SQL限流规则，为避免主实例SQL限流规则对只读业务造成影响，请在升级前审视调整主实例SQL限流规则、以及主实例和只读实例的SQL限流开关。
以下场景不支持RDS for MySQL 5.7升级至8.0：
- 不支持已绑定DDM或已开通数据库代理的RDS for MySQL实例进行升级。
- 不支持单机、本地盘、集群版实例进行升级。
- 主实例下的只读实例带有SQL限流规则时，不支持升级，请在升级前删除只读的限流规则。

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

表1 升级检查项及修复建议
检查项	检查内容	修复建议
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'），并修改相应表中时间数值为标准格式。

表2 升级失败的修复建议
问题描述	影响	修复建议
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，详见表1。
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”，进入RDS信息页面。
在“实例管理”页面，单击主实例名称。
在“概览”页面的“数据库引擎版本”处，单击“升级数据库版本”。

图1 升级数据库大版本
在弹出框中，确认升级信息，然后单击“下一步”。

图2 升级信息确认
- 对于RDS for MySQL 5.7升级至8.0的场景，执行7。
- 其他升级场景，执行8。
升级预检查。

图3 开始预检查

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

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

图4 预检查完成
选择升级方式，单击“确定”。
- 立即升级：系统会立即升级您的数据库版本到当前5.7或8.0最新版本。
- 可维护时间段内升级：系统会在您设置的可维护时间段内，升级您的数据库版本到当前5.7或8.0最新版本。详情请参见设置可维护时间段。
图5 选择升级方式

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