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

来源:这里教程网 时间:2026-02-28 20:38:26 作者:

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 PARTITION
LIST
分区的合法性校验更严格:不再允许合并包含
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
对含
NULL
LIST
分区,改用
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 后
subpartition
KEY
分区限制加剧

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 某个补丁版就变成硬性报错。动手前务必查清目标小版本的具体变更日志,别只看大版本号。

相关推荐