在PostgreSQL中，分区表由父表和多个子分区构成，很多用户尝试用TRUNCATE TABLE ONLY父表的方式来快速清空数据，但这种方式在分区表上有着特殊的表现，需要我们先理解它的运行机制。
TRUNCATE TABLE与ONLY关键字的基本用法
ONLY关键字用于指定只操作表本身，不递归处理继承表或子分区。对于普通继承表，它可以避免清掉子表。语法如下：
-- 只清空父表本身，不处理子表（普通表或继承表场景） TRUNCATE TABLE ONLY sales_parent;
但是在声明式分区（partitioned table）中，父表本身不存储数据，数据都在子分区里。
在分区表上使用ONLY的问题
当你对一个声明式分区表使用TRUNCATE TABLE ONLY时，由于父表没有数据，执行后看起来没有报错，但子分区数据原封不动。示例如下：
-- 创建分区表
CREATE TABLE measurement (
city_id int,
logdate date,
peaktemp int
) PARTITION BY RANGE (logdate);
CREATE TABLE measurement_y2023 PARTITION OF measurement
FOR VALUES FROM ('2023-01-01') TO ('2024-01-01');
-- 插入测试数据
INSERT INTO measurement VALUES (1, '2023-06-01', 30);
-- 使用ONLY清空父表
TRUNCATE TABLE ONLY measurement;
-- 查询子分区，数据仍在
SELECT count(*) FROM measurement_y2023;
上述代码中，TRUNCATE TABLE ONLY measurement只作用于空父表，子分区measurement_y2023中的记录不会被删除。
快速清空所有分区数据的正确方式
如果目标是快速清空整个分区表的所有数据，直接省略ONLY即可，PostgreSQL会自动递归清空所有子分区：
-- 清空父表及全部子分区数据 TRUNCATE TABLE measurement;
若只想清空某一个分区，应直接对该子分区执行TRUNCATE：
-- 仅清空指定子分区 TRUNCATE TABLE measurement_y2023;
使用ONLY的适用场景对比
| 操作对象 | 使用ONLY | 执行效果 |
|---|---|---|
| 普通表 | 可用 | 清空该表本身 |
| 继承表父表 | 可用 | 只清父表，不影响子表 |
| 声明式分区父表 | 无意义 | 父表无数据，子分区不变 |
| 声明式分区子分区 | 可用 | 清空该子分区 |
总结建议
在PostgreSQL中，使用TRUNCATE TABLE加上ONLY关键字并不能快速清空分区表的实际数据，因为声明式分区的数据存储在子分区中。正确做法是直接TRUNCATE父表以递归清空全部分区，或精确TRUNCATE某个子分区。理解ONLY在分区表中的局限性，能帮助你避免误操作并提升数据维护效率。
PostgreSQL分区表TRUNCATE_TABLE_ONLY修改时间：2026-07-30 04:03:18