DROP SCHEMA
Aplica-se a: SQL do Databricks 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.
-
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 usandoCASCADE
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;