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