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

Apache Doris 中文参考:TRUNCATE-TABLE

· 52CE 我爱测

**1. ** > 指定数据库的标识符(即名称)。 > > 标识符必须以字母字符(如果开启 unicode 名字支持,则可以是任意语言文字的字符)开头,并且不能包含空格或特殊字符,除非整个标识符字符串用反引号括起来(例如 )。 > > 标识符不能使用保留关键字。 > > 有关更多详细信息,请参阅标识符要求和保留关键字。

描述

该语句用于清空指定表和分区的数据

语法

TRUNCATE TABLE [<db_name>.]<table_name>[ PARTITION ( <partition_name1> [, <partition_name2> ... ] ) ];

必选参数

1.<db_name>

指定数据库的标识符(即名称)。

标识符必须以字母字符(如果开启 unicode 名字支持,则可以是任意语言文字的字符)开头,并且不能包含空格或特殊字符,除非整个标识符字符串用反引号括起来(例如My Database)。

标识符不能使用保留关键字。

有关更多详细信息,请参阅标识符要求和保留关键字。

2.<table_name>

指定表的标识符(即名称),在其所在的数据库(Database)中必须唯一。

标识符必须以字母字符(如果开启 unicode 名字支持,则可以是任意语言文字的字符)开头,并且不能包含空格或特殊字符,除非整个标识符字符串用反引号括起来(例如My Object)。

标识符不能使用保留关键字。

有关更多详细信息,请参阅标识符要求和保留关键字。

可选参数

1.<partition_name>

指定分区的标识符(即名称)。

标识符必须以字母字符(如果开启 unicode 名字支持,则可以是任意语言文字的字符)开头,并且不能包含空格或特殊字符,除非整个标识符字符串用反引号括起来(例如My Object)。

标识符不能使用保留关键字。

有关更多详细信息,请参阅标识符要求和保留关键字。

权限控制

执行此 SQL 命令的用户必须至少具有以下权限:

权限(Privilege) 对象(Object) 说明(Notes)
Drop_priv 表(Table) TRUNCATE TABLE 属于表 DROP 操作

注意事项

  • 该语句清空数据,但保留表或分区。
  • 不同于 DELETE,该语句只能整体清空指定的表或分区,不能添加过滤条件。
  • 不同于 DELETE,使用该方式清空数据不会对查询性能造成影响。
  • 该操作删除的数据不可恢复。
  • 使用该命令时,表状态需为 NORMAL,即不允许正在进行 SCHEMA CHANGE 等操作。
  • 该命令可能会导致正在进行的导入失败。

示例

  1. 清空 example_db 下的表 tbl

    TRUNCATE TABLE example_db.tbl;
    
  2. 清空表 tbl 的 p1 和 p2 分区

    TRUNCATE TABLE tbl PARTITION(p1, p2);
    

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

资料来源与适用范围

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

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

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