閱讀英文

共用方式為

DROP CATALOG

  • 發行項

適用於：標示為是 Databricks SQL 標示為是 Databricks Runtime 10.4 LTS 和更新版本，標示為是 只適用於 Unity 目錄

刪除目錄。 如果目錄不存在於中繼存放區中，就會擲回例外狀況。 若要卸除目錄，您必須對該目錄擁有 MANAGE 許可權，或是為其擁有者。

語法

DROP CATALOG [ IF EXISTS ] catalog_name [ RESTRICT | CASCADE ]

參數

  • IF EXISTS

    如果有指定，當目錄不存在時，不會拋出任何例外。

  • catalog_name：

    中繼存放區中現有目錄的名稱。 如果名稱不存在，則會擲回例外狀況。

  • RESTRICT

    如果指定，則會限制刪除非空的目錄。 預設為啟用。

  • CASCADE

    如果指定，則會遞歸地卸除所有相關聯的資料庫 （schemas） 和其中的物件。 在 Unity Catalog 中，刪除一個目錄時，使用 CASCADE 進行軟刪除資料表：受控資料表檔案會在 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;