大网数据广告活动
数据库部署与 SQL 参考

Truncate 操作

· 52CE 我爱测

用于一次性清空指定表或分区中的全部数据,仅保留表结构与分区定义。相比 ,它不会产生删除版本,因此不会影响后续查询性能,是大批量清理场景下的首选方式。

TRUNCATE 用于一次性清空指定表或分区中的全部数据,仅保留表结构与分区定义。相比 DELETE,它不会产生删除版本,因此不会影响后续查询性能,是大批量清理场景下的首选方式。

快速导航

何时选择 TRUNCATE

TRUNCATE 适合需要一次性清空大量数据的场景:

  • 测试环境重置:清空测试数据,准备重新导入
  • 分区数据重建:清空指定分区后重新写入修正数据
  • 大批量数据清理:相较 DELETE,无版本累积,不影响查询性能
  • 历史数据归档后清理:归档完成后清空原表或分区

语法与参数

命令格式

TRUNCATE TABLE [db.]tbl [PARTITION(p1, p2, ...)] [FORCE];

参数说明

参数 必选 说明
db. 否 数据库名,省略时使用当前数据库
tbl 是 待清空的表名
PARTITION(..) 否 指定分区名列表,仅清空这些分区;省略时清空整张表
FORCE 否 直接物理删除数据,不可通过 RECOVER 恢复,请谨慎使用

使用示例

1. 清空整张表

清空 example_db 下 tbl 表的所有数据:

TRUNCATE TABLE example_db.tbl;

2. 清空指定分区

仅清空 tbl 表的 p1 与 p2 分区:

TRUNCATE TABLE tbl PARTITION(p1, p2);

3. 强制清空(不可恢复)

直接物理删除 example_db.tbl 的数据,跳过回收站:

TRUNCATE TABLE example_db.tbl FORCE;

使用 FORCE 后无法通过 RECOVER 找回数据,请确认无误后再执行。

使用约束

执行 TRUNCATE 前请确认以下条件:

  • 仅清数据,保留结构:表结构与分区定义保留,仅清空数据
  • 不支持过滤条件:只能整体清空表或指定分区,无法附加 WHERE 条件
  • 表状态必须为 NORMAL:正在执行 SCHEMA CHANGE 的表无法 TRUNCATE
  • 影响进行中的导入:可能导致正在执行的导入任务失败,建议在导入空闲期执行
  • 默认可恢复:未使用 FORCE 时,可在保留期内通过 RECOVER 恢复

数据恢复

执行 TRUNCATE 时若未指定 FORCE,被清空的数据会进入回收站,可在保留期内恢复:

RECOVER TABLE [db_name.]table_name;

详见 RECOVER 语句说明。

回收站保留时长由 FE 配置项 catalog_trash_expire_second 控制,过期数据将被彻底清理。

TRUNCATE vs DELETE

两者都可用于删除数据,但适用场景差异明显:

对比项 TRUNCATE DELETE
删除粒度 整张表或整个分区 行级,可附加 WHERE 条件
是否支持过滤 不支持 支持
查询性能影响 不影响 产生删除版本,影响查询性能
执行速度 极快(元数据级操作) 与命中行数相关
默认是否可恢复 可通过 RECOVER 恢复(非 FORCE) 不可直接恢复
典型场景 大批量清空、分区重建 精确删除少量数据

选型建议:

  • 需要清空整表或整个分区,优先使用 TRUNCATE
  • 需要按条件删除部分数据,使用 DELETE

常见问题

TRUNCATE 会删除表结构吗?

不会。TRUNCATE 只清空数据,表结构、分区定义、索引等元信息均保留。

TRUNCATE 后能否恢复数据?

  • 未加 FORCE:可通过 RECOVER 在保留期内恢复
  • 加了 FORCE:数据被物理删除,无法恢复

表正在做 SCHEMA CHANGE 时能 TRUNCATE 吗?

不能。表状态必须为 NORMAL,否则命令会报错。请等待 SCHEMA CHANGE 完成后再执行。

TRUNCATE 会影响正在进行的导入任务吗?

可能会导致进行中的导入任务失败。建议在导入空闲期执行,或先暂停相关导入。

TRUNCATE 与 DROP TABLE 有什么区别?

  • TRUNCATE:保留表结构,仅清空数据
  • DROP TABLE:删除表本身,包括结构与数据

能否只清空某个分区的部分数据?

不能。TRUNCATE 只能整体清空表或指定分区,不支持行级过滤。如需按条件删除,请使用 DELETE。

相关文档

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。