Partilhar via

DROP CATALOG

  • Artigo

Aplica-se a:assinalado como sim Databricks SQL assinalado como sim Databricks Runtime 10.4 LTS e superior assinalado como sim apenas Catálogo Unity

Lança um catálogo. Uma exceção será lançada se o catálogo não existir no metastore. Para eliminares um catálogo, deves ter o privilégio MANAGE no catálogo ou ser o seu proprietário.

Sintaxe

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

Parâmetros

  • SE EXISTE

    Se especificado, nenhuma exceção é lançada quando o catálogo não existe.

  • catalog_name:

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

  • RESTRINGIR

    Se for especificado, impede o cancelamento de um catálogo que não esteja 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 catálogo usando CASCADE exclui tabelas de forma suave: os ficheiros das tabelas geridas serão apagados após 30 dias, mas os ficheiros 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;