DROP CATALOG

适用于：勾选“是” Databricks SQL 勾选标记为“是” Databricks Runtime 10.4 LTS 及更高版本 勾选标记为“是” 仅限 Unity Catalog

删除目录。 如果元存储中不存在该目录，则会引发异常。 要删除目录，您必须对目录拥有 MANAGE 权限或成为其所有者。

语法

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

参数

  • 如果存在

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

  • catalog_name：

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

  • 限制

    如果指定此项，则限制删除非空目录。 默认情况下启用。

  • 级 联

    如果指定此项，则递归删除所有关联的数据库（架构）及其中的对象。

    注释

    在 Unity 目录中，使用 CASCADE 软删除目录及其子对象删除目录。 保留托管表和卷的数据文件，以允许 7 天恢复窗口。 恢复窗口结束后，数据文件将在 48 小时内永久删除（清除）。 不会删除外部表和外部卷的文件。 有关详细信息，请参阅 Unity 目录中的对象存储生命周期。

示例

-- 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;
  • Last updated on