適用於:
Databricks SQL
Databricks Runtime 10.4 LTS 和更新版本,
只適用於 Unity 目錄
刪除目錄。 如果目錄不存在於中繼存放區中,就會擲回例外狀況。 若要卸除目錄,您必須對該目錄擁有 MANAGE 許可權,或是為其擁有者。
語法
DROP CATALOG [ IF EXISTS ] catalog_name [ RESTRICT | CASCADE ]
參數
如果存在
如果有指定,當目錄不存在時,不會拋出任何例外。
-
中繼存放區中現有目錄的名稱。 如果名稱不存在,則會擲回例外狀況。
限制
如果指定,則會限制刪除非空的目錄。 預設為啟用。
級聯
如果指定,則會遞歸地刪除所有相關聯的資料庫(結構)及其中的物件。 在 Unity Catalog 中,使用
CASCADE軟刪除目錄時,會軟刪除數據表:受控數據表檔案將在 7 到 30 天內被清除,但外部檔案不會被刪除。
範例
-- Create a `vaccine` catalog
> CREATE CATALOG vaccine COMMENT 'This catalog is used to maintain information about vaccines';
-- Drop the catalog and its schemas
> DROP CATALOG vaccine CASCADE;
-- Drop the catalog using IF EXISTS and only if it is empty.
> DROP CATALOG IF EXISTS vaccine RESTRICT;