DROP TABLE

Name

DROP TABLE -- Removes a table from a database.

Synopsis

DROP TABLE name [, ...]

Parameters

name

The name of an existing table you intend to drop. You may drop multiple tables by specifying their names in a comma-delimited list.

Results

DROP

The message returned when a table is dropped successfully.

ERROR: table "name" does not exist!

The error returned if the specified table or view name does not exist in the database.

Description

DROP TABLE removes tables from the database. You must be the owner of the table, or a superuser, in order to drop it.

Note: To empty a table (as opposed to completely deleting it), use either the TRUNCATE or DELETE command.

Deleting a table also destroys any indices that were placed on that table.

Example

The following command permanently removes the employees table from the booktown database:

booktown=# DROP TABLE employees;
DROP