Instructions DROP

Documentation des instructions DROP

Supprime une entité existante. Si la clause IF EXISTS est spécifiée, ces requêtes ne renvoient pas d’erreur si l’entité n’existe pas. Si le modificateur SYNC est spécifié, l’entité est supprimée sans attendre.

​

DROP DATABASE

Supprime toutes les tables de la base de données db, puis la base de données db elle-même.

Syntaxe :

DROP DATABASE [IF EXISTS] db [ON CLUSTER cluster] [SYNC]

​

DROP TABLE

Supprime une ou plusieurs tables.

Pour annuler la suppression d’une table, consultez UNDROP TABLE

Syntaxe :

DROP [TEMPORARY] TABLE [IF EXISTS] [IF EMPTY]  [db1.]name_1[, [db2.]name_2, ...] [ON CLUSTER cluster] [SYNC]

Limites :

• Si la clause IF EMPTY est spécifiée, le serveur vérifie que la table est vide uniquement sur la réplique qui a reçu la requête.
• La suppression de plusieurs tables à la fois n’est pas une opération atomique : si la suppression d’une table échoue, les tables suivantes ne seront pas supprimées.

​

DROP DICTIONARY

Supprime le dictionnaire.

Syntaxe :

DROP DICTIONARY [IF EXISTS] [db.]name [SYNC]

​

DROP USER

Supprime un utilisateur.

Syntaxe :

DROP USER [IF EXISTS] name [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]

​

DROP ROLE

Supprime un rôle. Le rôle supprimé est révoqué de toutes les entités auxquelles il avait été attribué.

Syntaxe :

DROP ROLE [IF EXISTS] name [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]

​

DROP ROW POLICY

Supprime une ROW POLICY. La ROW POLICY supprimée est révoquée pour toutes les entités auxquelles elle était attribuée.

Syntaxe :

DROP [ROW] POLICY [IF EXISTS] name [,...] ON [database.]table [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]

​

DROP MASKING POLICY

Supprime une politique de masquage.

Syntaxe:

DROP MASKING POLICY [IF EXISTS] name ON [database.]table [ON CLUSTER cluster_name] [FROM access_storage_type]

​

DROP QUOTA

Supprime un quota. Le quota supprimé est révoqué de toutes les entités auxquelles il avait été attribué.

Syntaxe :

DROP QUOTA [IF EXISTS] name [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]

​

DROP SETTINGS PROFILE

Supprime un profil de paramètres. Le profil de paramètres supprimé est révoqué de toutes les entités auxquelles il était attribué.

Syntaxe :

DROP [SETTINGS] PROFILE [IF EXISTS] name [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]

​

DROP VIEW

Supprime une vue. Les vues peuvent également être supprimées avec une commande DROP TABLE, mais DROP VIEW vérifie que [db.]name est bien une vue.

Syntaxe :

DROP VIEW [IF EXISTS] [db.]name [ON CLUSTER cluster] [SYNC]

​

DROP FUNCTION

Supprime une fonction définie par l’utilisateur créée avec CREATE FUNCTION. Les fonctions système ne peuvent pas être supprimées.

Syntaxe

DROP FUNCTION [IF EXISTS] function_name [on CLUSTER cluster]

Exemple

CREATE FUNCTION linear_equation AS (x, k, b) -> k*x + b;
DROP FUNCTION linear_equation;

​

DROP NAMED COLLECTION

Supprime une collection nommée.

Syntaxe

DROP NAMED COLLECTION [IF EXISTS] name [on CLUSTER cluster]

Exemple

CREATE NAMED COLLECTION foobar AS a = '1', b = '2';
DROP NAMED COLLECTION foobar;