DROP CATALOG (Databricks SQL)

重要

Unity Catalog 目前为公共预览版。 要使用该预览版,请联系 Azure Databricks 代表。

删除目录。 如果元存储中不存在该目录,则会引发异常。

语法

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

参数

  • IF EXISTS

    如果已指定,则当目录不存在时,不会引发异常。

  • catalog_name:

    元存储中现有目录的名称。 如果该名称不存在,则会引发异常。

  • RESTRICT

    如果已指定,将限制删除非空目录,并且默认情况下处于启用状态。

  • CASCADE

    如果指定,将删除所有关联的数据库(架构)及其中的对象。

示例

-- 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;