Compartilhar via


DROP SCHEMA

Aplica-se a:marca de seleção positiva SQL do Databricks caixa de seleção marcada sim Runtime do Databricks

Remove um esquema e exclui o diretório associado a ele do sistema de arquivos. Uma exceção será gerada se o esquema não existir no sistema. Para remover um esquema, você deve ter o privilégio MANAGE no esquema ou ser seu proprietário.

Embora o uso de SCHEMA e DATABASE seja intercambiável, SCHEMA é preferencial.

Sintaxe

DROP SCHEMA [ IF EXISTS ] schema_name [ RESTRICT | CASCADE ]

Parâmetros

  • IF EXISTS

    Se especificado, nenhuma exceção será gerada quando o esquema não existir.

  • schema_name

    O nome de um esquema existente no sistema. Se o nome não existir, será gerada uma exceção.

  • RESTRICT

    Se especificado, estará habilitado por padrão e restringirá a remoção de um esquema que não está vazio.

  • CASCADE

    Se especificado, removerá todas as tabelas e funções associadas recursivamente. No Catálogo do Unity, a remoção de um esquema usando CASCADE excluirá temporariamente as tabelas: os arquivos de tabela gerenciados serão limpos após 30 dias, mas os arquivos externos não serão excluídos. Aviso! Se o esquema for gerenciado pelo metastore do Hive no nível do workspace, a remoção de um esquema usando CASCADE excluirá recursivamente todos os arquivos no local especificado, independentemente do tipo de tabela (gerenciado ou externo).

Exemplos

-- Create `inventory_schema` Database
> CREATE SCHEMA inventory_schema COMMENT 'This schema is used to maintain Inventory';

-- Drop the schema and its tables
> DROP SCHEMA inventory_schema CASCADE;

-- Drop the schema using IF EXISTS
> DROP SCHEMA IF EXISTS inventory_schema CASCADE;