DROP SCHEMA

  • Article

S’applique à : case marquée oui Databricks SQL oui coché Databricks Runtime

Annule un schéma et supprime le répertoire associé au schéma du système de fichiers. Si le schéma n’existe pas dans le système, une exception est levée. Vous devez être le propriétaire d’un schéma pour le supprimer.

Bien que SCHEMA et DATABASE soient interchangeables, il est préférable d’utiliser SCHEMA.

Syntaxe

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

Paramètres

  • IF EXISTS

    S’il est spécifié, aucune exception n’est levée quand le schéma n’existe pas.

  • schema_name

    Nom d’un schéma existant dans le système. Si le nom n’existe pas, une exception est levée.

  • RESTRICT

    S’il est spécifié, bloque la suppression d’un schéma non vide (activé par défaut).

  • CASCADE

    S’il est spécifié, supprime toutes les tables et fonctions associées de manière récursive. Dans Unity Catalog, la suppression d’un schéma 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. Avertissement ! Si le schéma est managé par le metastore Hive au niveau de l’espace de travail, la suppression d’un schéma avec CASCADE supprime de manière récursive tous les fichiers situés à l’emplacement spécifié, quel que soit le type des tables (managées ou externes).

Exemples

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