Partager via


DROP CATALOG

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

  • S’IL EXISTE

    Aucune exception n’est levée si le catalogue n’existe pas, lorsque cela est spécifié.

  • catalog_name :

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

  • RESTREINDRE

    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 à l’aide de CASCADE entraîne une suppression progressive des tables : les fichiers des tables gérées seront nettoyés dans les 7 à 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;