DROP TABLE

Remove a table

Synopsis:

DROP TABLE [IF EXISTS] [database-name.] table-name

Description:

The DROP TABLE statement removes a table added with the CREATE TABLE statement. The name specified is the table name. It is completely removed from the database schema and the disk file. The table can not be recovered. All indexes associated with the table are also deleted.

The DROP TABLE statement doesn't reduce the size of the database file in the default mode. Empty space in the database is retained for later INSERTs. To remove free space in the database, use the VACUUM command. If the auto-vacuum mode is enabled for a database, then space will be freed automatically by DROP TABLE.

The optional IF EXISTS clause suppresses the error that would normally result if the table doesn't exist.