DROP SCHEMA

Se aplica a:casilla marcada como Sí Databricks SQL casilla marcada como Sí Databricks Runtime

Anula un esquema y elimina el directorio asociado al esquema del sistema de archivos. Se lanza una excepción si el esquema no existe en el sistema. Para quitar un esquema, debe tener el privilegio MANAGE en el esquema o ser su propietario.

Aunque se pueden usar tanto SCHEMA como DATABASE, se prefiere SCHEMA.

Sintaxis

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

Parámetros

  • SI EXISTE

    Si se especifica, no se lanza ninguna excepción cuando el esquema no existe.

  • schema_name

    El nombre de un esquema existente en el sistema. Si el nombre no existe, se produce una excepción.

  • RESTRINGIR

    Si se especifica, restringe la anulación de un esquema que no está vacío y de manera predeterminada está habilitado.

  • CASCADA

    Si se especifica, quita todas las tablas y funciones asociadas de forma recursiva.

    Note

    En el catálogo de Unity, quitar un esquema mediante CASCADE elimina temporalmente el esquema y sus objetos secundarios. Los archivos de datos para tablas y volúmenes administrados se conservan para permitir una ventana de recuperación de 7 días. Una vez finalizada la ventana de recuperación, los archivos de datos se eliminan permanentemente (purgan) en un plazo de 48 horas. Los archivos de tablas externas y volúmenes externos no se eliminan. Para obtener más información, consulte Ciclo de vida de almacenamiento de objetos en el catálogo de Unity.

    Advertencia. Si el metastore de Hive de nivel de área de trabajo administra el esquema y se elimina un esquema mediante CASCADE, se eliminarán de forma recursiva todos los archivos de la ubicación especificada, independientemente del tipo de tabla (administrado o externo).

Ejemplos

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