MySQL分区表由存储引擎支持,PHP仅能通过直连执行CREATE TABLE ... PARTITION BY语句;需确保MySQL启用partition插件、分区字段为NOT NULL的DATE/DATETIME类型、分区键包含在主键中,且不可使用预处理。

MySQL分区表必须在存储引擎层支持,PHP只是执行SQL的客户端
PHP本身不提供“创建分区表”的内置函数或扩展——分区是MySQL 5.3+(尤其是5.7/8.0)对InnoDB和MyISAM表的物理组织机制。PHP能做的,仅是通过PDO或mysqli发送符合语法的CREATE TABLE ... PARTITION BY ...语句。如果执行失败,90% 是因为MySQL服务端未启用分区支持,或语法写错。
验证是否支持:
SELECT PLUGIN_NAME, PLUGIN_STATUS FROM INFORMATION_SCHEMA.PLUGINS WHERE PLUGIN_NAME = 'partition';返回
ACTIVE才可继续。
按 RANGE 分区最常用,但日期字段必须是DATE/DATETIME类型且不能为NULL
很多PHP开发者用strtotime()生成时间戳再插入,却忘了建表时把字段定义成INT——这会导致PARTITION BY RANGE (created_at)直接报错ERROR 1486 (HY000): Constant, random or timezone-dependent expressions in (sub)partitioning function are not allowed。
- 正确做法:字段用
DATE或DATETIME,例如created_at DATE NOT NULL - 分区表达式写成
PARTITION BY RANGE (TO_DAYS(created_at)),不是UNIX_TIMESTAMP() - 每个
PARTITION的VALUES LESS THAN必须是升序整数,如TO_DAYS('2024-01-01')→739220,不能写字符串
示例语句:
CREATE TABLE logs (
id BIGINT UNSIGNED AUTO_INCREMENT,
created_at DATE NOT NULL,
content TEXT,
PRIMARY KEY (id, created_at)
) ENGINE=InnoDB
PARTITION BY RANGE (TO_DAYS(created_at)) (
PARTITION p2023 VALUES LESS THAN (TO_DAYS('2024-01-01')),
PARTITION p2024 VALUES LESS THAN (TO_DAYS('2025-01-01')),
PARTITION p_future VALUES LESS THAN MAXVALUE
);
PHP执行时需禁用预处理语句,否则PARTITION语法会报错
PDO::prepare()和mysqli::prepare()不支持含PARTITION子句的DDL语句,调用execute()会触发SQLSTATE[HY000]: General error: 1564 Partition management on a not partitioned table is not possible之类误导性错误。
立即学习“PHP免费学习笔记(深入)”;
- 必须用直连执行:
$pdo->exec($sql)或$mysqli->query($sql) - 确保
$sql是完整字符串,不要拼接用户输入——分区语句本就不该动态生成 - 若需按月自动建分区,应在运维脚本中用Shell+MySQL CLI完成,而非PHP Web请求
分区键必须包含在主键/唯一索引中,否则CREATE TABLE直接被MySQL拒绝
这是最容易被忽略的硬性约束。例如以下语句必然失败:
CREATE TABLE orders ( id BIGINT PRIMARY KEY, order_date DATE, amount DECIMAL(10,2) ) PARTITION BY RANGE (TO_DAYS(order_date));报错
ERROR 1503 (HY000): A PRIMARY KEY must include all columns in the table's partitioning function。
修正方式只有两种:
— 把分区字段加入主键:PRIMARY KEY (id, order_date)
— 或改用KEY(非唯一)索引配合ORDER BY id查询,接受一定性能折损
注意:UNIQUE KEY同样受此限制,且无法像普通索引那样绕过。
WHERE created_at BETWEEN ? AND ?加联合索引,比仓促上分区更稳妥。真正需要分区的场景,往往已脱离PHP应用层控制,属于DBA和基础设施协同范畴。











