Partilhar via

DROP CATALOG

  • Artigo

Aplica-se a:marca de verificação sim Databricks SQL marca de verificação sim Databricks Runtime 10.4 LTS e superior marca de verificação sim Unity Catalog apenas

Deixa cair um catalog. Uma exceção será lançada se o catalog não existir no metastore. Para descartar um catalog, você deve ter o privilégio MANAGE na catalog ou ser o seu proprietário.

Sintaxe

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

Parameters

  • SE EXISTE

    Se especificado, nenhuma exceção é lançada quando o catalog não existe.

  • catalog_name:

    O nome de um catalog existente no metastore. Se o nome não existir, uma exceção será lançada.

  • RESTRINGIR

    Se especificado, restringe o descarte de um catalognão vazio. Ativado por predefinição.

  • CASCATA

    Se especificado, descarta todos os bancos de dados associados (esquemas) e os objetos dentro deles, recursivamente. No Unity Catalog, eliminar um catalog usando CASCADE provoca o apagamento suave de tables: os arquivos de table gerenciados serão removidos após 30 dias, mas os arquivos externos não serão excluídos.

Exemplos

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