DROP TABLE
適用於:Databricks SQL
Databricks Runtime
刪除資料表,並在數據表不是 EXTERNAL
數據表時,從文件系統中移除與數據表相關聯的目錄。 如果資料表不存在,則會拋出例外狀況。
若要卸除數據表,您必須擁有該數據表的 MANAGE
許可權,或是成為該數據表的擁有者,或者是該數據表所在的架構、目錄或中繼存放區的擁有者。
如果是外部數據表,則只會從中繼存放區架構中移除相關聯的元數據資訊。
參考資料表的任何外鍵約束也會被刪除。
如果資料表已被快取,命令會移除該資料表及其所有相依物件的快取。
注意
從 Unity Catalog 中卸除受控資料表時,其基礎資料會在 30 天內從您的雲端租戶中刪除。
語法
DROP TABLE [ IF EXISTS ] table_name
參數
IF EXISTS
如果指定,當數據表不存在時,不會擲回任何 TABLE_OR_VIEW_NOT_FOUND 錯誤。
-
要刪除的資料表名稱。 名稱不得包含 時態規格或選項規格。 如果找不到數據表,Azure Databricks 就會引發 TABLE_OR_VIEW_NOT_FOUND 錯誤。
範例
-- Assumes a table named `employeetable` exists.
> DROP TABLE employeetable;
-- Assumes a table named `employeetable` exists in the `userdb` schema
> DROP TABLE userdb.employeetable;
-- Assumes a table named `employeetable` does not exist.
-- Throws TABLE_OR_VIEW_NOT_FOUND
> DROP TABLE employeetable;
Error: TABLE_OR_VIEW_NOT_FOUND
-- Assumes a table named `employeetable` does not exist,Try with IF EXISTS
-- this time it will not throw exception
> DROP TABLE IF EXISTS employeetable;