Saltar al contenido principal
Elimina una entidad existente. Si se especifica la cláusula IF EXISTS, estas consultas no devuelven ningún error si la entidad no existe. Si se especifica el modificador SYNC, la entidad se elimina sin demora.

DROP DATABASE

Elimina todas las tablas de la base de datos db y luego elimina la propia base de datos db. Sintaxis:
DROP DATABASE [IF EXISTS] db [ON CLUSTER cluster] [SYNC]

DROP TABLE

Elimina una o más tablas.
Para revertir la eliminación de una tabla, consulta UNDROP TABLE
Sintaxis:
DROP [TEMPORARY] TABLE [IF EXISTS] [IF EMPTY]  [db1.]name_1[, [db2.]name_2, ...] [ON CLUSTER cluster] [SYNC]
Limitaciones:
  • Si se especifica la cláusula IF EMPTY, el servidor comprueba si la tabla está vacía solo en la réplica que recibió la consulta.
  • Eliminar varias tablas a la vez no es una operación atómica; es decir, si falla la eliminación de una tabla, las siguientes no se eliminarán.

DROP DICTIONARY

Elimina el diccionario. Sintaxis:
DROP DICTIONARY [IF EXISTS] [db.]name [SYNC]

DROP USER

Elimina un usuario. Sintaxis:
DROP USER [IF EXISTS] name [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]

DROP ROLE

Elimina un rol. El rol eliminado se revoca de todas las entidades a las que estaba asignado. Sintaxis:
DROP ROLE [IF EXISTS] name [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]

DROP ROW POLICY

Elimina una ROW POLICY. La ROW POLICY eliminada se revoca de todas las entidades a las que se había asignado. Sintaxis:
DROP [ROW] POLICY [IF EXISTS] name [,...] ON [database.]table [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]

DROP MASKING POLICY

Elimina una política de enmascaramiento. Sintaxis:
DROP MASKING POLICY [IF EXISTS] name ON [database.]table [ON CLUSTER cluster_name] [FROM access_storage_type]

DROP QUOTA

Elimina una QUOTA. La QUOTA eliminada se revoca de todas las entidades a las que se había asignado. Sintaxis:
DROP QUOTA [IF EXISTS] name [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]

DROP SETTINGS PROFILE

Elimina un perfil de configuración. El perfil de configuración eliminado se revoca de todas las entidades a las que estaba asignado. Sintaxis:
DROP [SETTINGS] PROFILE [IF EXISTS] name [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]

DROP VIEW

Elimina una vista. Las vistas también se pueden eliminar con el comando DROP TABLE, pero DROP VIEW comprueba que [db.]name sea una vista. Sintaxis:
DROP VIEW [IF EXISTS] [db.]name [ON CLUSTER cluster] [SYNC]

DROP FUNCTION

Elimina una función definida por el usuario creada con CREATE FUNCTION. Las funciones del sistema no se pueden eliminar. Sintaxis
DROP FUNCTION [IF EXISTS] function_name [on CLUSTER cluster]
Ejemplo
CREATE FUNCTION linear_equation AS (x, k, b) -> k*x + b;
DROP FUNCTION linear_equation;

DROP NAMED COLLECTION

Elimina una colección con nombre. Sintaxis
DROP NAMED COLLECTION [IF EXISTS] name [on CLUSTER cluster]
Ejemplo
CREATE NAMED COLLECTION foobar AS a = '1', b = '2';
DROP NAMED COLLECTION foobar;
Última modificación el 10 de junio de 2026