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
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.