DROP SCHEMA

Supprime un schéma. Pour un schéma externe, vous pouvez également supprimer la base de données externe associée au schéma. La commande n’est pas réversible.

Privilèges requis

Les privilèges suivants sont requis pour DROP SCHEMA :

• Superuser

• Propriétaire du schéma

• Utilisateurs disposant du privilège DROP SCHEMA

Syntaxe

DROP SCHEMA [ IF EXISTS ] name [, ...]
[ DROP EXTERNAL DATABASE ]
[ CASCADE | RESTRICT ]

Paramètres

IF EXISTS

Clause indiquant que si le schéma spécifié n’existe pas, la commande ne doit faire aucune modification et renvoyer un message selon lequel le schéma n’existe pas, plutôt que de mettre fin avec une erreur.

Comme cette clause est utile lors de l’écriture de scripts, le script n’échoue pas si DROP SCHEMA s’exécute sur un schéma qui n’existe pas.

nom

Noms des schémas à supprimer. Vous pouvez spécifier plusieurs noms de schémas séparés par des virgules.

DROP EXTERNAL DATABASE

Clause qui indique que si un schéma externe est supprimé, il convient de supprimer la base de données externe associée au schéma externe, si elle existe. Si aucune base de données externe n’existe, la commande renvoie un message indiquant qu’aucune base de données externe n’existe. Si plusieurs schémas externes sont supprimés, toutes les bases de données associées aux schémas spécifiés sont supprimées.

Si une base de données externe contient des objets dépendants tels que des tables, incluez l’option CASCADE pour supprimer également ces objets dépendants.

Lorsque vous supprimez une base de données externe, cette base de données est également supprimée pour tous les autres schémas externes associés à la base de données. Les tables définies dans d’autres schémas externes utilisant cette base de données sont également supprimées.

DROP EXTERNAL DATABASE ne prend pas en charge les bases de données externes stockées dans un metastore HIVE.

CASCADE

Mot-clé qui indique de supprimer automatiquement tous les objets figurant dans le schéma. Si DROP EXTERNAL DATABASE est spécifiée, tous les objets figurant dans la base de données externe sont également supprimés.

RESTRICT

Mot-clé qui indique de ne pas supprimer un schéma ou une base de données externe s’il contient ou si elle contient des objets. Il s’agit de l’action par défaut.

Exemple

L’exemple suivant supprime un schéma nommé S_SALES. Cet exemple utilise RESTRICT comme mécanisme de sécurité de telle sorte que le schéma n’est pas supprimé s’il contient des objets. Dans ce cas, vous devez supprimer les objets du schéma avant de supprimer le schéma.

drop schema s_sales restrict;

L’exemple suivant supprime un schéma nommé S_SALES et tous les objets qui dépendent de ce schéma.

drop schema s_sales cascade;

L’exemple suivant supprime le schéma S_SALES s’il existe, ou ne fait rien et renvoie un message dans le cas contraire.

drop schema if exists s_sales;

L’exemple suivant supprime un schéma externe nommé S_SPECTRUM et la base de données externe qui lui est associée. Cet exemple utilise RESTRICT pour ne pas supprimer le schéma et la base de données s’ils contiennent des objets. Dans ce cas, vous devez supprimer les objets dépendants avant de supprimer le schéma et la base de données.

drop schema s_spectrum drop external database restrict;

L’exemple suivant supprime plusieurs schémas et les bases de données externes qui leur sont associées, ainsi que tous les objets dépendants éventuels.

drop schema s_sales, s_profit, s_revenue drop external database cascade;