DROP CATALOG

Se aplica a:casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 10.4 LTS y versiones posteriores casilla marcada como Sí solo Unity Catalog

Anula un catálogo. Si el catálogo no existe en el metastore, se produce una excepción. Para eliminar un catálogo, debe tener el privilegio MANAGE en el catálogo o ser su propietario.

Sintaxis

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

Parámetros

  • SI EXISTE

    Si se especifica, no se produce ninguna excepción cuando el catálogo no existe.

  • catalog_name:

    Nombre de un catálogo existente en el metastore. Si el nombre no existe, se produce una excepción.

  • RESTRINGIR

    Si se especifica, restringirá la eliminación de un catálogo no vacío. De forma predeterminada está habilitado.

  • CASCADA

    Si se especifica, quitará todas las bases de datos asociadas (esquemas) y los objetos que contenga de forma recursiva.

    Nota:

    En el catálogo de Unity, quitar un catálogo mediante CASCADE elimina temporalmente el catálogo 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.

Ejemplos

-- 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;
  • Last updated on