必须用REORGANIZE PARTITION拆分MAXVALUE分区,先确认RANGE分区及时间列表达式,校验分区名、索引与非NULL约束,确保新区间无缝递增,操作会重写数据并阻塞写入。
拆分 MAXVALUE 分区前必须确认表使用 RANGE 分区且有明确时间列
mysql 的 split partition 仅支持 range 和 list 分区,而 maxvalue 是 range 分区的终止标记——如果表是 hash 或 key 分区,或时间列不是分区表达式的一部分(比如用 to_days(created_at) 但你误以为直接用了 created_at),执行会直接报错 error 1503 (hy000): a primary key must include all columns in the table's partitioning function 或更模糊的 error 1064。
实操建议:
- 先查清分区定义:
SHOW CREATE TABLE your_table_name,确认PARTITION BY RANGE后的表达式(如TO_DAYS(log_time))和现有分区边界 - 确保目标列(如
log_time)有索引且非 NULL;否则新增分区可能因数据校验失败而中断 - 检查是否有未提交的长事务正在写入该分区——
SPLIT PARTITION是 DDL 操作,会锁整个表(MySQL 5.7)或至少锁对应分区(8.0+),阻塞写入
正确写法:用 ALTER TABLE ... REORGANIZE PARTITION 替代 SPLIT PARTITION
MySQL 官方语法中**没有** SPLIT PARTITION 这个独立命令。真实操作是用 REORGANIZE PARTITION 把含 MAXVALUE 的旧分区“切开”,并显式定义两个新区间。它本质是原子性地删除旧分区 + 创建两个新分区 + 搬运数据。
常见错误现象:直接写 ALTER TABLE t REORGANIZE PARTITION p_max INTO (PARTITION p_202401 VALUES LESS THAN (TO_DAYS('2024-02-01')), PARTITION p_max VALUES LESS THAN MAXVALUE); 却忘了原分区名必须和 REORGANIZE PARTITION 后面写的完全一致(包括大小写),否则报错 ERROR 1517 (HY000): Duplicate partition name p_max。
实操建议:
- 先用
SELECT PARTITION_NAME, TABLE_ROWS FROM INFORMATION_SCHEMA.PARTITIONS WHERE TABLE_NAME = 'your_table'确认当前MAXVALUE分区的真实名称(常为p_max或pt_max) - 拆分时,新区间上限必须严格递增且无缝衔接,例如原分区是
VALUES LESS THAN MAXVALUE,你想按月拆,就得写成:REORGANIZE PARTITION p_max INTO (PARTITION p_202406 VALUES LESS THAN (TO_DAYS('2024-07-01')), PARTITION p_max VALUES LESS THAN MAXVALUE) - 避免跨月拆分(如从 2024-01-01 拆到 2024-03-01),否则中间两个月的数据会全部落入第一个新区间,导致后续无法再按月维护
性能与数据安全:拆分过程不丢数据,但耗时受原分区大小影响
REORGANIZE PARTITION 不是元数据操作,它会实际读取、过滤、重写原 MAXVALUE 分区中的每一行。若该分区存了千万级数据,操作可能持续数分钟甚至小时,期间写入被阻塞(MySQL 8.0.29+ 支持部分 Online DDL,但仍需额外配置 ALGORITHM=INPLACE 且不总生效)。
实操建议:
- 拆分前用
SELECT COUNT(*) FROM your_table WHERE log_time >= '2024-06-01' AND log_time 预估要挪入新区间的行数,比全量 <code>TABLE_ROWS更准 - 生产环境务必在低峰期执行,并提前在从库验证语句是否可跑通(注意从库延迟可能导致
REORGANIZE在主从不一致状态下开始) - 不要依赖
mysqldump做备份后立即拆分——dump 过程本身可能锁表,且备份文件不含分区结构变更,恢复后仍需手动重建
容易被忽略的兼容性细节:函数必须和建表时完全一致
如果建表时用的是 PARTITION BY RANGE (YEAR(create_time)),那拆分时也必须用 YEAR(),不能换成 TO_DAYS() 或 UNIX_TIMESTAMP(),否则 MySQL 认为分区表达式不匹配,直接拒绝执行,报错 ERROR 1486 (HY000): Constant expression is required for column list。
实操建议:
- 复制
SHOW CREATE TABLE输出中PARTITION BY RANGE括号内的完整表达式,粘贴到REORGANIZE语句里复用 - 时间函数对 NULL 敏感:若分区列允许 NULL,而函数(如
TO_DAYS(NULL))返回NULL,会导致这部分数据无法落入任何新区间,被静默丢弃——务必提前UPDATE补默认值或加WHERE过滤 - MySQL 5.7 对
MAXVALUE分区的REORGANIZE支持稳定,但 8.0.30+ 开始限制更严,例如禁止在二级分区(SUBPARTITION)上直接操作,需先解耦
真正麻烦的从来不是语法写对没,而是建表时选的分区函数、允许的 NULL 值、以及当时没想清楚的边界条件,会在拆分时突然咬你一口。










