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.

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

Permissions

Para quitar un esquema en el catálogo de Unity, debe tener el MANAGE privilegio en el esquema o ser su propietario, además USE SCHEMA del esquema y USE CATALOG del catálogo donde reside el esquema.

Según la jerarquía de objetos, el propietario del catálogo primario y los usuarios con MANAGE en el catálogo primario también pueden realizar esta operación.

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;