描述

TRUNCATE可以快速移除一组表中的所有行。 它的效果与对每个表执行不带条件的DELETE相同， 但由于它并不实际扫描这些表，因此速度更快。此外，它会立即回收磁盘空间， 而不是要求后续再执行一次VACUUM操作。这一点对于大表尤其有用。

参数

注解

要截断一个表，你必须拥有该表上的TRUNCATE权限。

TRUNCATE会在其操作的每个表上获取 ACCESS EXCLUSIVE锁，这会阻塞该表上的所有其他并发操作。 当指定RESTART IDENTITY时，任何需要重新启动的 sequence 也会同样被排他锁定。如果需要对某个表进行并发访问，则应改用 DELETE命令。

TRUNCATE不能用于被其他表通过外键引用的表， 除非所有这类表也在同一条命令中被截断。因为在这种情况下检查有效性将需要 扫描表，而该命令的意义恰恰在于避免这样做。CASCADE 选项可用于自动包含所有依赖表 — 但使用该选项时一定要非常小心， 否则你可能会丢失并非有意删除的数据！ 特别要注意的是，当要截断的表是一个分区时，其同级分区不会受到影响， 但级联会无差别地扩展到所有引用它的表以及这些表的全部分区。

TRUNCATE不会引发这些表上可能存在的任何 ON DELETE触发器，但会引发 ON TRUNCATE触发器。如果这些表中的任何一个 定义了ON TRUNCATE触发器，那么所有 BEFORE TRUNCATE触发器都会在任何截断发生之前 引发，而所有AFTER TRUNCATE触发器都会在最后一次 截断完成且所有 sequence 被重置之后引发。触发器会按照表的处理顺序 引发（先是命令中列出的表，然后是由于级联而加入的表）。

TRUNCATE不是多版本并发控制（MVCC）安全的。截断之后， 如果并发事务使用的是在截断发生前取得的快照， 该表对这些并发事务而言将表现为空。详见Section 13.6。

就表中数据而言，TRUNCATE是事务安全的： 如果外围事务没有提交，截断将被安全地回滚。

当指定RESTART IDENTITY时，隐含的 ALTER SEQUENCE RESTART操作也会以事务方式执行； 也就是说，如果外围事务没有提交，它们也会被回滚。请注意，如果在 事务回滚前又对这些重启后的 sequence 执行了额外操作，这些操作对 sequence 本身的影响会被回滚，但对currval()的影响不会被回滚。 也就是说，事务结束后，currval()仍将反映失败事务内取得的 最后一个 sequence 值，即使 sequence 本身可能已经不再与之保持一致。 这与失败事务之后currval()的通常行为类似。

如果外部数据包装器支持，TRUNCATE也可以用于外部表， 例如参见postgres_fdw。

示例

截断表bigtable和 fattable：

TRUNCATE bigtable, fattable;

同样的操作，并重置所有相关联的 sequence 生成器：

TRUNCATE bigtable, fattable RESTART IDENTITY;

截断表othertable，并级联到任何通过 外键约束引用othertable的表：

TRUNCATE othertable CASCADE;

兼容性

SQL:2008 标准包括了一个TRUNCATE命令， 语法是TRUNCATE TABLE tablename。子句 CONTINUE IDENTITY/RESTART IDENTITY 在该标准中也有出现，但其含义虽相关却略有不同。该命令的某些并发行为在标准中 被留作实现定义，因此必要时应结合上述注解并与其他实现进行比较。

另见