Compartilhar via


CATÁLOGO DE DESTINO

Aplica-se a:verificação marcada como sim Databricks SQL verificação marcada como sim Databricks Runtime 10.4 LTS e superior caixa de seleção marcada sim somente para o Catálogo do Unity

Remove um catálogo. Uma exceção será gerada se o catálogo não existir no metastore. Para remover um catálogo, você precisa ser o respectivo proprietário.

Sintaxe

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

Parâmetros

  • IF EXISTS

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

  • catalog_name:

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

  • RESTRICT

    Se especificado, restringe a remoção de um catálogo que não estiver vazio. Habilitado por padrão.

  • CASCADE

    Se especificado, remove todos os bancos de dados associados (esquemas) e os objetos dentro deles, recursivamente. No Catálogo do Unity, a remoção de um catálogo usando CASCADE excluirá as tabelas temporariamente: os arquivos de tabela gerenciados serão limpos 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;