Partager via

DROP CATALOG

  • Article

S’applique à :coche marquée oui Databricks SQL coche marquée oui Databricks Runtime 10.4 LTS et versions ultérieures oui coché Unity Catalog uniquement

Supprime un catalogue. Une exception est levée si le catalogue n’existe pas dans le metastore. Pour supprimer un catalogue, vous devez disposer du privilège MANAGE sur le catalogue ou être son propriétaire.

Syntaxe

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

Paramètres

  • IF EXISTS

    S’il est spécifié, aucune exception n’est levée lorsque le catalogue n’existe pas.

  • catalog_name:

    Nom d’un catalogue existant dans le metastore. Si le nom n’existe pas, une exception est levée.

  • RESTRICT

    Si cette option est spécifiée, elle limite la suppression d’un catalogue non vide. Option activée par défaut.

  • CASCADE

    Si cette option est spécifiée, elle supprime toutes les bases de données (schémas) associées et les objets qu’elles contiennent de manière récursive. Dans Unity Catalog, la suppression d’un catalogue avec CASCADE supprime les tables de façon réversible : les fichiers des tables managées sont nettoyés après 30 jours, mais les fichiers externes ne sont pas supprimés.

Exemples

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