DROP TABLE
The DROP TABLE statement removes a table.
Syntax
DROP TABLE [ IF EXISTS ] <table_name> [, ...];Parameters
<table_name>— fully qualified as<workspace>.<collection>.<table_name>. Multiple names may be given, comma-separated, to drop several tables in one statement.IF EXISTS— skip the operation without error if the table does not exist, instead of refusing the statement.
Examples
Drop a Table
DROP TABLE workspace.collection.staging_data;Drop Multiple Tables
DROP TABLE workspace.collection.table1, workspace.collection.table2;Drop Only If It Exists
DROP TABLE IF EXISTS workspace.collection.staging_data;Notes
- Requires the
ownerrole on the table, and a connector that supports dropping — not every backend does. CASCADE,RESTRICTandPURGEare not supported and are rejected when the query is planned rather than accepted and ignored.DROP TABLEagainst a materialized view is rejected and points you to DROP MATERIALIZED VIEW — its backing table cannot be dropped out from under it.- Dropping a table removes the data it holds; this cannot be undone.