TRUNCATE TABLE （Transact-SQL）

2025-07-29

适用于：SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics 分析平台系统（PDW）Microsoft Fabric 中的仓库Microsoft Fabric 预览版中的 SQL 数据库

删除表中的所有行或表中指定的分区，不记录单个行删除操作。 TRUNCATE TABLE与没有DELETE子句的WHERE语句类似;但是，速度更快，TRUNCATE TABLE使用较少的系统和事务日志资源。

Transact-SQL 语法约定

Syntax

SQL Server、Azure SQL 数据库、Fabric SQL 数据库的语法

TRUNCATE TABLE
    { database_name.schema_name.table_name | schema_name.table_name | table_name }
    [ WITH ( PARTITIONS ( { <partition_number_expression> | <range> }
    [ , ...n ] ) ) ]
[ ; ]

<range> ::=
<partition_number_expression> TO <partition_number_expression>

Microsoft Fabric、Azure Synapse Analytics 和并行数据仓库的语法。

TRUNCATE TABLE { database_name.schema_name.table_name | schema_name.table_name | table_name }
[ ; ]

Arguments

database_name

数据库的名称。

schema_name

表所属的架构的名称。

table_name

要截断或从中删除所有行的表的名称。 table_name 须是文本。 table_name 不能是 OBJECT_ID() 函数或变量。

WITH ( PARTITIONS ( { <partition_number_expression | >range< } [ , ...n ] ) )

适用于：SQL Server 2016 (13.x) 及更高版本。

指定要截断或删除其中所有行的分区。如果未对表进行分区，则 WITH PARTITIONS 参数将生成错误。如果未提供子 WITH PARTITIONS 句，将截断整个表。

可以通过下列方式指定 <partition_number_expression>：

提供分区号，例如：WITH (PARTITIONS (2))
提供若干单独分区的分区号，并用逗号分隔，例如：WITH (PARTITIONS (1, 5))
同时提供范围和单独分区，例如：WITH (PARTITIONS (2, 4, 6 TO 8))
<range> 可以指定为用单词 TO分隔的分区号，例如： WITH (PARTITIONS (6 TO 8))

要截断一个已分区表，表和索引必须对齐（在同一个分区函数上进行分区）。

Remarks

与 DELETE 语句相比， TRUNCATE TABLE 具有以下优势：

所用的事务日志空间较少。

该 DELETE 语句一次删除一行，并记录每个已删除行的事务日志中的条目。 TRUNCATE TABLE 通过解除分配用于存储表和索引数据的数据页并仅记录事务日志中的页面解除分配来删除数据。
使用的锁通常较少。

DELETE使用行锁执行该语句时，表中的每一行都会被锁定以删除。 TRUNCATE TABLE 始终锁定表（包括架构（SCH-M）锁和页，但不会锁定每一行。
不例外，表或其索引中留有零页。

DELETE执行语句后，表仍可以包含空页。例如，在没有至少具有独占表LCK_M_X锁的情况下，堆中的空页无法解除分配。如果删除作不使用表锁，则表（堆）可能包含许多空页。对于索引，该 DELETE 语句可以保留空页。然后，后台清理过程会解除分配这些页面。

TRUNCATE TABLE 从表中删除所有行，但表结构及其列、约束、索引等仍保留。若要删除表定义及其数据，请使用 DROP TABLE 语句。

如果表包含标识列，该列的计数器重置为该列定义的种子值。如果未定义种子，则使用默认值 1 。若要保留标识计数器，请改用 DELETE 。

TRUNCATE TABLE可以在事务中回滚操作。

在 Fabric SQL 数据库中，截断表会删除该表的 Fabric OneLake 中的所有镜像数据。

Deferred deallocation

当使用 128 个盘区或更多区的表被截断时，数据库引擎会延迟实际页面解除分配及其关联的锁，直到事务提交后。截断发生在两个单独的阶段：逻辑阶段和物理阶段。在逻辑阶段，表及其索引使用的现有分配单元被标记为解除分配并锁定，直到事务提交。在物理阶段，后台进程删除标记为解除分配的页面。这意味着释放的空间 TRUNCATE TABLE 可能无法立即用于新分配。

如果启用了加速数据库恢复，则截断将使用单独的逻辑和物理阶段，而不考虑盘区数。

Limitations

不能在以下表上使用 TRUNCATE TABLE ：

由 FOREIGN KEY 约束引用。可以截断具有引用自身的外键的表。
参与索引视图的表。
通过使用事务复制或合并复制发布的表。
系统版本控制时态表。
由 EDGE 约束引用。

对于具有一个或多个这些特征的表，请改用 DELETE 该语句。

TRUNCATE TABLE 无法激活触发器，因为该操作不会记录单个行删除。有关详细信息，请参阅 CREATE TRIGGER (Transact-SQL)。

在 Azure Synapse Analytics 和 Analytics Platform System (PDW) 中：

TRUNCATE TABLE 不允许在 EXPLAIN 语句中。
TRUNCATE TABLE 不能在事务内部执行。

Permissions

所需的最低权限是 table_name 上的 ALTER 权限。 TRUNCATE TABLE权限默认为表所有者、固定服务器角色的成员sysadmin和db_ownerdb_ddladmin固定数据库角色，并且不可传输。但是，可以在诸如存储过程这样的模块中加入 TRUNCATE TABLE 语句，然后为使用 EXECUTE AS 子句的模块授予适当的权限。

Examples

A. 截断表

下面的示例删除 JobCandidate 表中的所有数据。在 SELECT 语句之前和之后使用 TRUNCATE TABLE 语句来比较结果。

USE AdventureWorks2022;

SELECT COUNT(*) AS BeforeTruncateCount
FROM HumanResources.JobCandidate;

TRUNCATE TABLE HumanResources.JobCandidate;

SELECT COUNT(*) AS AfterTruncateCount
FROM HumanResources.JobCandidate;

B. 截断表分区

适用于：SQL Server 2016 (13.x) 及更高版本。

下面的示例将截断已分区表的指定分区。 WITH (PARTITIONS (2, 4, 6 TO 8)) 语法导致分区号 2、4、6、7 和 8 被截断。

TRUNCATE TABLE PartitionTable1
WITH (PARTITIONS (2, 4, 6 TO 8));
GO

C. 回滚截断操作

以下示例演示如何 TRUNCATE TABLE 回滚事务中的操作。

创建包含三行的测试表。

USE [tempdb];

CREATE TABLE TruncateTest (ID INT IDENTITY (1, 1) NOT NULL);
GO
INSERT INTO TruncateTest DEFAULT VALUES;
GO 3

在截断之前检查数据。
```
SELECT ID FROM TruncateTest;
```

截断事务中的表，并检查行数。

BEGIN TRANSACTION;

TRUNCATE TABLE TruncateTest;

SELECT ID FROM TruncateTest;

可以看到该表为空。

回滚事务并检查数据。
```
ROLLBACK TRANSACTION;

SELECT ID FROM TruncateTest;
```
可以看到所有三行。
清理表。
```
DROP TABLE TruncateTest;
```