Skip to main content

DROP TABLE

Removes a table from your data source.

When dropping an Apache Iceberg table:

  • For Open Catalog and other supported Lakehouse Catalogs, the DROP TABLE command removes a table from the catalog. The data files are not deleted from the storage.
  • For Amazon S3 data sources, the DROP TABLE command logically removes a table from the source and physically removes all files associated with the table. After the table is dropped, it is permanently deleted and cannot be restored.
Syntax 
DROP TABLE [ IF EXISTS ] <table_name>

Parameters​

[ IF EXISTS ] Optional

When included, the command will succeed regardless of whether the table existed. If this clause is not specified, the command will fail if the table to be dropped does not exist.

<table_name> String

The name of the table that you want to drop.

Example​

Drop table 
DROP TABLE demo.example_table