Supported versions: Current (18) / 17 / 16 / 15 / 14

Development versions: 19 / 20devel

Unsupported versions: 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

Historical version. PostgreSQL 8.0 has reached end of support. See the current manual.

TRUNCATE

Name

TRUNCATE -- empty a table

Synopsis

TRUNCATE [ TABLE ] name

Description

TRUNCATE quickly removes all rows from a table. It has the same effect as an unqualified DELETE but since it does not actually scan the table it is faster. This is most useful on large tables.

Parameters

name: The name (optionally schema-qualified) of the table to be truncated.

Notes

Only the owner of a table may TRUNCATE it.

TRUNCATE cannot be used if there are foreign-key references to the table from other tables. Checking validity in such cases would require table scans, and the whole point is not to do one.

TRUNCATE will not run any user-defined ON DELETE triggers that might exist for the table.

Examples

Truncate the table bigtable:

TRUNCATE TABLE bigtable;

Compatibility

There is no TRUNCATE command in the SQL standard.

Report a documentation issue

Read the upstream documentation. For corrections, first check the current manual.