> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Documentação para instruções DROP

# Instruções 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.

<div id="drop-database">
  ## DROP DATABASE
</div>

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

Sintaxe:

```sql theme={null}
DROP DATABASE [IF EXISTS] db [ON CLUSTER cluster] [SYNC]
```

<div id="drop-table">
  ## DROP TABLE
</div>

Exclui uma ou mais tabelas.

<Tip>
  Para reverter a exclusão de uma tabela, consulte [UNDROP TABLE](/pt-BR/reference/statements/undrop)
</Tip>

Sintaxe:

```sql theme={null}
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.

<div id="drop-dictionary">
  ## DROP DICTIONARY
</div>

Exclui o dicionário.

Sintaxe:

```sql theme={null}
DROP DICTIONARY [IF EXISTS] [db.]name [SYNC]
```

<div id="drop-user">
  ## DROP USER
</div>

Remove um usuário.

Sintaxe:

```sql theme={null}
DROP USER [IF EXISTS] name [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]
```

<div id="drop-role">
  ## DROP ROLE
</div>

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

Sintaxe:

```sql theme={null}
DROP ROLE [IF EXISTS] name [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]
```

<div id="drop-row-policy">
  ## DROP ROW POLICY
</div>

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

Sintaxe:

```sql theme={null}
DROP [ROW] POLICY [IF EXISTS] name [,...] ON [database.]table [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]
```

<div id="drop-masking-policy">
  ## DROP MASKING POLICY
</div>

Exclui uma política de mascaramento.

Sintaxe:

```sql theme={null}
DROP MASKING POLICY [IF EXISTS] name ON [database.]table [ON CLUSTER cluster_name] [FROM access_storage_type]
```

<div id="drop-quota">
  ## DROP QUOTA
</div>

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

Sintaxe:

```sql theme={null}
DROP QUOTA [IF EXISTS] name [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]
```

<div id="drop-settings-profile">
  ## DROP SETTINGS PROFILE
</div>

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:

```sql theme={null}
DROP [SETTINGS] PROFILE [IF EXISTS] name [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]
```

<div id="drop-view">
  ## DROP VIEW
</div>

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:

```sql theme={null}
DROP VIEW [IF EXISTS] [db.]name [ON CLUSTER cluster] [SYNC]
```

<div id="drop-function">
  ## DROP FUNCTION
</div>

Remove uma função definida pelo usuário criada com [CREATE FUNCTION](/pt-BR/reference/statements/create/function).
As funções do sistema não podem ser removidas.

**Sintaxe**

```sql theme={null}
DROP FUNCTION [IF EXISTS] function_name [on CLUSTER cluster]
```

**Exemplo**

```sql theme={null}
CREATE FUNCTION linear_equation AS (x, k, b) -> k*x + b;
DROP FUNCTION linear_equation;
```

<div id="drop-named-collection">
  ## DROP NAMED COLLECTION
</div>

Exclui uma coleção nomeada.

**Sintaxe**

```sql theme={null}
DROP NAMED COLLECTION [IF EXISTS] name [on CLUSTER cluster]
```

**Exemplo**

```sql theme={null}
CREATE NAMED COLLECTION foobar AS a = '1', b = '2';
DROP NAMED COLLECTION foobar;
```