TRUNCATE

清空表的所有行。

概要

  1. TRUNCATE [TABLE] [ONLY] name [ * ] [, ...]
  2.      [ RESTART IDENTITY | CONTINUE IDENTITY ] [CASCADE | RESTRICT]

描述

TRUNCATE快速删除一个表或一组表中的所有行。 它与在每个表上进行不限定DELETE的效果相同， 但是由于它实际上并不扫描表，因此速度更快。 这在大型表上最有用。

您必须在表上具有TRUNCATE特权才能清空表行。

TRUNCATE在对其操作的表上获取访问排他锁，这将阻止该表上的所有其他并发操作。 如果指定了RESTART IDENTITY，则将要重新计数的所有序列都将被排他地锁定。 如果需要并发访问表，则应改用DELETE命令。

参数

name

要清空的表的名称（可以用schema修饰）。 如果在表名之前指定了ONLY，则仅该表被清空。 如果未指定ONLY，则该表及其所有子表（如果有）将被清空。 （可选）可以在表名称后指定*，以显式指示包括子表。

CASCADE

因为此关键字适用于外键引用（Greenplum数据库中不支持），所以它无效。

RESTART IDENTITY

自动重新启动被清空表的列所拥有的序列。

CONTINUE IDENTITY

不要更改序列的值。这是默认值。

RESTRICT

因为此关键字适用于外键引用（Greenplum数据库中不支持），所以它无效。

注解

TRUNCATE将不会运行表可能存在的任何用户定义的ON DELETE触发器。

TRUNCATE不会清空从指定表继承的任何表。 仅指定的表被清空，而不是其子表。

TRUNCATE不会清空分区表的任何子表。 如果指定分区表的子表，则TRUNCATE不会从该表及其子表中删除行。

TRUNCATE不是MVCC安全的。 清空后，如果并发事务使用清空发生之前获取的快照，则该表将对并发事务显示为空。

对于表中的数据，TRUNCATE是事务安全的：如果所属的事务未提交，则清空将被安全地回滚。

TRUNCATE在其操作的每个表上获取ACCESS EXCLUSIVE锁，该锁将阻止该表上的所有其他并发操作。 如果需要并发访问表，则应改用DELETE命令。

当指定了RESTART IDENTITY时，隐式的ALTER SEQUENCE RESTART操作也将以事务方式完成； 也就是说，如果所在的事务没有提交，它们将被回滚。 这不同于ALTER SEQUENCE RESTART的正常行为。 请注意，如果在事务回滚之前对重新启动的序列执行了任何其他序列操作，则这些操作对序列的影响将被回滚，但不会对currval()产生影响。 也就是说，在事务currval()之后，它将继续反映在失败的事务中获得的最后一个序列值，即使序列本身可能不再与此一致。 这类似于事务失败后currval()的通常行为。

示例

清空表films和distributors：

  1. TRUNCATE films, distributors;

相同，并重置所有关联的序列生成器：

  1. TRUNCATE films, distributors RESTART IDENTITY;

兼容性

SQL：2008标准包括带有语法TRUNCATE TABLE tablename的TRUNCATE命令。 子句CONTINUE IDENTITY/RESTART IDENTITY也出现在该标准中，但是尽管具有相关的含义，但略有不同。 该命令的一些并发行为由标准实现定义，因此应考虑上述注意事项，并在必要时与其他实现进行比较。

另见

DELETE , DROP TABLE

Parent topic: SQL Command Reference