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

> Documentação da instrução ALTER TABLE ... DELETE

# ALTER TABLE ... DELETE

```sql theme={null}
ALTER TABLE [db.]table [ON CLUSTER cluster] DELETE [IN PARTITION partition_expr1 [, partition_expr2 ...]] WHERE filter_expr
```

Exclui os dados que correspondem à expressão de filtro especificada. Implementado como uma [mutação](/pt-BR/reference/statements/alter/index#mutations).

<Warning>
  O prefixo `ALTER TABLE` indica que esta é uma operação pesada, ao contrário de consultas semelhantes em bancos de dados OLTP. `ALTER TABLE ... DELETE` regrava cada parte de dados que contém linhas correspondentes à expressão de filtro, gerando uma quantidade substancial de E/S de gravação. Use-o com moderação, pois ele pode afetar o desempenho de `SELECT`.

  Para tabelas `MergeTree`, considere usar a [consulta `DELETE FROM`](/pt-BR/reference/statements/delete), que realiza uma exclusão leve e pode ser consideravelmente mais rápida. Para workloads que exigem exclusões ou correções frequentes, considere usar [`ReplacingMergeTree`](/pt-BR/concepts/features/operations/update/replacing-merge-tree) ou [`CollapsingMergeTree`](/pt-BR/reference/engines/table-engines/mergetree-family/collapsingmergetree).
</Warning>

A `filter_expr` deve ser do tipo `UInt8`. A consulta exclui as linhas da tabela para as quais essa expressão assume um valor diferente de zero.

Uma consulta pode conter vários comandos separados por vírgulas.

A cláusula `IN PARTITION` limita a mutação às partições listadas. Sem ela, em tabelas da família `ReplicatedMergeTree`, quando a configuração [optimize\_mutations\_with\_partition\_pruning](/pt-BR/reference/settings/session-settings/optimize) está habilitada (o padrão), o ClickHouse detecta automaticamente as condições de chave de particionamento em `filter_expr` e aplica a mutação apenas nas partições afetadas. Em tabelas `MergeTree` não replicadas, use uma cláusula `IN PARTITION` explícita para limitar a mutação a partições específicas.

A sincronia do processamento da consulta é definida pela configuração [mutations\_sync](/pt-BR/reference/settings/session-settings/mutations#mutations_sync). Por padrão, ela é assíncrona.

**Veja também**

* [Mutações](/pt-BR/reference/statements/alter/index#mutations)
* [Sincronia das consultas ALTER](/pt-BR/reference/statements/alter/index#synchronicity-of-alter-queries)
* configuração [mutations\_sync](/pt-BR/reference/settings/session-settings/mutations#mutations_sync)

## Conteúdo relacionado

* Blog: [Lidando com atualizações e exclusões no ClickHouse](https://clickhouse.com/blog/handling-updates-and-deletes-in-clickhouse)