DROP SCHEMA

S’applique à :case cochée oui Databricks SQL case cochée oui 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. Pour supprimer un schéma, vous devez disposer du privilège MANAGE sur le schéma ou être son propriétaire.

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

  • S’IL EXISTE

    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.

  • RESTREINDRE

    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.

    Note

    Dans le catalogue Unity, la suppression d’un schéma à l’aide CASCADE de suppressions réversibles du schéma et de ses objets enfants. Les fichiers de données des tables et volumes managés sont conservés pour permettre une fenêtre de récupération de 7 jours. Une fois la fenêtre de récupération terminée, les fichiers de données sont définitivement supprimés (vidés) dans les 48 heures. Les fichiers pour les tables externes et les volumes externes ne sont pas supprimés. Pour plus d’informations, consultez le cycle de vie du stockage d’objets dans le catalogue Unity.

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