DROP

Exclui uma entidade existente. Se a cláusula IF EXISTS for especificada, essas instruções não retornam erro se a entidade não existir. Se o modificador SYNC for especificado, a entidade é removida sem atraso.

Exclui todas as tabelas do banco de dados db e, em seguida, exclui o próprio banco de dados db.

Sintaxe:

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

Exclui uma ou mais tabelas.

Sintaxe:

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

Limitações:

• Se a cláusula IF EMPTY for especificada, o servidor verifica se a tabela está vazia apenas na réplica que recebeu a consulta.
• A exclusão de várias tabelas de uma só vez não é uma operação atômica; ou seja, se a exclusão de uma tabela falhar, as tabelas subsequentes não serão excluídas.

Exclui o dicionário.

Sintaxe:

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

Remove um usuário.

Sintaxe:

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

Exclui uma role. A role excluída é removida de todas as entidades às quais foi atribuída.

Sintaxe:

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

Exclui uma ROW POLICY. A ROW POLICY excluída é removida de todas as entidades às quais foi atribuída.

Sintaxe:

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

Exclui uma política de mascaramento.

Sintaxe:

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

Exclui uma QUOTA. A QUOTA excluída tem sua atribuição revogada em todas as entidades às quais foi atribuída.

Sintaxe:

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

Exclui um perfil de configurações. O perfil de configurações excluído é revogado de todas as entidades às quais havia sido atribuído.

Sintaxe:

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

Exclui uma view. Views também podem ser excluídas com o comando DROP TABLE, mas DROP VIEW verifica se [db.]name é uma view.

Sintaxe:

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

Remove uma função definida pelo usuário criada com CREATE FUNCTION. As funções do sistema não podem ser removidas.

Sintaxe

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

Exemplo

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

Exclui uma coleção nomeada.

Sintaxe

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

Exemplo

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