mysql版本迁移中的分区表与存储引擎兼容性

14次阅读

mysql 5.7 升级到 8.0 后 PARTITION BY RANGE 报错主因是 8.0 强制要求 innodb_file_per_table=ON 且仅支持 InnoDB 分区表;8.0.29+ 严格校验 LIST 分区 NULL 处理;ARCHIVE 分区表在 8.0 被彻底移除;8.0.33+ 限制 KEY 子分区列必须属于主分区键。

mysql版本迁移中的分区表与存储引擎兼容性

MySQL 5.7 升级到 8.0 后 PARTITION BY RANGE 报错:”Error 1064 (42000)“

这不是语法错误,而是 MySQL 8.0 默认禁用了 innodb_file_per_table=OFF 场景下的分区表创建(尤其当原表使用 MyISAM 或旧式共享表空间时)。8.0 要求所有分区表必须基于 InnoDB,且每个分区需独立物理文件 —— 这直接依赖 innodb_file_per_table=ON

实操建议:

  • 升级前检查:
    select @@innodb_file_per_table, @@default_storage_engine;
  • 若为 0,需先在 5.7 环境执行 SET GLOBAL innodb_file_per_table = ON;,再对每个分区表执行 ALTER TABLE tbl_name ENGINE=InnoDB; 触发文件拆分
  • 禁止在 8.0 初始化实例后,用 mysqldump --compatible=mysql40 导入含分区定义的 SQL —— 它会抹掉 PARTITION 子句但不报错,导致结构丢失

ALTER TABLE ... REORGANIZE PARTITION 在 8.0.29+ 中行为突变

MySQL 8.0.29 起,REORGANIZE PARTITIONLIST 分区的合法性校验更严格:不再允许合并包含 NULL 值的分区,也不接受新分区定义中遗漏原 VALUES IN 列表里的任意值。

常见错误信息:ERROR 1659 (HY000): Cannot move rows between partitions that have different definitions for handling NULL values

实操建议:

  • 升级前运行 SELECT PARTITION_NAME, PARTITION_DESCRIPTION FROM INFORMATION_SCHEMA.PARTITIONS WHERE TABLE_NAME = 'your_table'; 检查是否有 NULL 显式出现在 PARTITION_DESCRIPTION
  • 对含 NULLLIST 分区,改用 ALTER TABLE ... EXCHANGE PARTITION + 临时表方式重组,避免直接 REORGANIZE
  • 8.0.29+ 的 REORGANIZE 不再隐式复制数据,而是原子重写元数据 —— 若中途失败,分区状态不可逆,务必在低峰期操作并提前锁表

从 MySQL 5.6 迁移至 8.0 时 ARCHIVE 分区表直接失效

ARCHIVE 存储引擎自 MySQL 8.0 起被彻底移除,任何含 ENGINE=ARCHIVE 的分区定义在 8.0 实例启动时就会拒绝加载,错误日志显示:Unknown storage engine 'ARCHIVE',整个表无法访问。

这不是兼容性警告,是硬性阻断。

实操建议:

  • 5.6/5.7 环境中,必须在迁移前将 ARCHIVE 分区表转为 InnoDB
    ALTER TABLE archived_log_table ENGINE=InnoDB ROW_FORMAT=COMPRESSED KEY_BLOCK_SIZE=4;
  • 不要试图用 mysqldump --skip-create-options 绕过引擎声明 —— CREATE TABLE 语句仍含 ENGINE=ARCHIVE,导入 8.0 时照样失败
  • 若原表仅用于归档且读写极少,可考虑迁出数据后改用 8.0 的 DATA Directory + 只读表空间管理,而非保留分区逻辑

MySQL 8.0.33 后 subpartitionKEY 分区限制加剧

8.0.33 强制要求:子分区(SUBPARTITION)若使用 KEY 类型,其列必须全部来自主分区键(PARTITION BY 所用列),不能再引用额外列。此前版本虽不推荐但允许。

错误示例:

CREATE TABLE logs (   id BIGINT,   ts DATETIME,   region VARCHAR(10) ) PARTITION BY RANGE (YEAR(ts)) SUBPARTITION BY KEY (region)  -- ❌ 8.0.33+ 拒绝:region 不在主分区键中

实操建议:

  • 升级前扫描所有含 SUBPARTITION BY KEY 的建表语句,确认子分区列是否严格属于主分区键字段集
  • 如需按 region 子分区,应改为 PARTITION BY RANGE COLUMNS(ts, region),或用 HASH 子分区配合计算列
  • 注意:8.0.33+ 的 KEY 子分区不再支持 ALgoRITHM=INPLACE,变更必须重建全表

分区表迁移不是单纯 dump & restore,引擎限制、语法容忍度、元数据校验强度都在逐版本收紧。最容易被忽略的是那些“曾经能跑”的隐式行为 —— 比如 5.7 允许的 NULL 分区合并、ARCHIVE 表跨版本加载、子分区列自由引用,到了 8.0 某个补丁版就变成硬性报错。动手前务必查清目标小版本的具体变更日志,别只看大版本号。

text=ZqhQzanResources