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

Description

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

Get Practical PostgreSQL now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.