↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1 / 7.0
历史版本。 PostgreSQL 8.3 已结束支持。 请参阅 当前版本手册.

TRUNCATE

TRUNCATE — 清空一个表或一组表

大纲

TRUNCATE [ TABLE ] name [, ...] [ CASCADE | RESTRICT ]

描述

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

参数

name

要截断的表名(可以是模式限定的)。

CASCADE

自动截断所有以外键引用任一已命名表的表,以及任何由于 CASCADE而被加入该组的表。

RESTRICT

如果任一表具有来自不被截断表的外键引用,则拒绝截断。这是默认值。

注解

只有表的拥有者才能对它执行TRUNCATE。

TRUNCATE不能用于被其他表通过外键引用的表,除非所有这类表也在同一条命令中被截断。因为在这种情况下检查有效性将需要扫描表,而该命令的意义恰恰在于避免这样做。CASCADE 选项可用于自动包含所有依赖表 — 但使用该选项时一定要非常小心,否则你可能会丢失并非有意删除的数据!

TRUNCATE不会运行这些表上可能存在的任何 ON DELETE触发器。

警告

TRUNCATE不是多版本并发控制(MVCC)安全的(有关 MVCC 的一般信息见第 13 章)。截断之后,即使并发事务使用的是在截断发生前取得的快照,该表对这些并发事务而言也将表现为空。这只会影响那些在截断发生前没有访问过被截断表的事务 — 任何访问过的事务都会持有至少一个ACCESS SHARE锁,这会阻塞TRUNCATE直到该事务完成。因此,截断不会在对同一表的连续查询之间造成明显的表内容不一致,但可能在被截断表的内容与数据库中其他表的内容之间造成可见的不一致。

不过,TRUNCATE是事务安全的:如果外围事务没有提交,截断将被安全地回滚。

示例

截断表bigtable和 fattable:

TRUNCATE bigtable, fattable;

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

TRUNCATE othertable CASCADE;

兼容性

SQL 标准中没有TRUNCATE命令。

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.