TRUNCATE TABLE (T-SQL)

Removes all rows from a table without logging the individual row deletes.

Syntax

TRUNCATE TABLE name

Arguments
name
Is the name of the table to truncate or remove all rows from.
Remarks

TRUNCATE TABLE is functionally identical to DELETE statement with no WHERE clause: both remove all rows in the table. But TRUNCATE TABLE is faster and uses fewer system and transaction log resources than DELETE.

The DELETE statement removes rows one at a time and records an entry in the transaction log for each deleted row. TRUNCATE TABLE removes the data by deallocating the data pages used to store the table’s data, and only the page deallocations are recorded in the transaction log.

TRUNCATE TABLE removes all rows from a table, but the table structure and its columns, constraints, indexes and so on remain. The counter used by an identity for new rows is reset to the seed for the column. If you want to retain the identity counter, use DELETE instead. If you want to remove table definition and its data, use the DROP TABLE statement.

You cannot use TRUNCATE TABLE on a table referenced by a FOREIGN KEY constraint; instead, use DELETE statement without a WHERE clause. Because TRUNCATE TABLE is not logged, it cannot activate a trigger.

Examples

This example removes all data from the authors table.

TRUNCATE TABLE authors

  

Permissions

TRUNCATE TABLE permissions default to the table owner and are not transferable.

See Also
DELETE DROP TABLE

  


(c) 1988-98 Microsoft Corporation. All Rights Reserved.