DROP TABLE
S’applique à :
Databricks SQL Databricks Runtime
Supprime la table et supprime du système de fichiers le répertoire associé à la table s'il ne s'agit pas d'une table EXTERNAL. Une exception est levée si la table n'existe pas.
Pour supprimer une table, vous devez disposer du privilège MANAGE sur la table, être son propriétaire ou le propriétaire du schéma, du catalogue ou du metastore dans lequel réside la table.
Dans le cas d’une table externe, seules les informations de métadonnées associées sont supprimées du schéma du metastore.
Toutes les contraintes de clé étrangère faisant référence à la table sont également supprimées.
Si la table est mise en cache, la commande annule la mise en cache de la table et de tous ses dépendants.
Remarque
Quand une table managée est supprimée d’Unity Catalog, ses données sous-jacentes sont supprimées de votre locataire cloud dans les 30 jours.
Syntaxe
DROP TABLE [ IF EXISTS ] table_name
Paramètre
IF EXISTS
S’il est spécifié, aucune erreur TABLE_OR_VIEW_NOT_FOUND n’est levée lorsque la table n’existe pas.
-
Le nom du tableau à annuler. Le nom ne doit pas inclure de spécification temporelle ou de spécification d’options. Si la table est introuvable, Azure Databricks génère une erreur TABLE_OR_VIEW_NOT_FOUND.
Exemples
-- Assumes a table named `employeetable` exists.
> DROP TABLE employeetable;
-- Assumes a table named `employeetable` exists in the `userdb` schema
> DROP TABLE userdb.employeetable;
-- Assumes a table named `employeetable` does not exist.
-- Throws TABLE_OR_VIEW_NOT_FOUND
> DROP TABLE employeetable;
Error: TABLE_OR_VIEW_NOT_FOUND
-- Assumes a table named `employeetable` does not exist,Try with IF EXISTS
-- this time it will not throw exception
> DROP TABLE IF EXISTS employeetable;