↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
测试与开发版本: 19 / devel
不受支持的版本: 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 已于 2013 年 2 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本。

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命令。

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。