> ## 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.

> Documentación de la sentencia DELETE de ALTER TABLE

# ALTER TABLE ... DELETE

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

Elimina los datos que coinciden con la expresión de filtrado especificada. Se implementa como una [mutación](/es/reference/statements/alter/index#mutations).

<Warning>
  El prefijo `ALTER TABLE` indica que se trata de una operación pesada, a diferencia de consultas similares en bases de datos OLTP. `ALTER TABLE ... DELETE` reescribe cada parte de datos que contiene filas que coinciden con la expresión de filtrado, lo que genera una cantidad considerable de E/S de escritura. Úselo con moderación, ya que puede afectar al rendimiento de `SELECT`.

  Para las tablas `MergeTree`, considere usar la [consulta `DELETE FROM`](/es/reference/statements/delete), que realiza una eliminación ligera y puede ser considerablemente más rápida. Para cargas de trabajo que requieren eliminaciones o correcciones frecuentes, considere usar [`ReplacingMergeTree`](/es/concepts/features/operations/update/replacing-merge-tree) o [`CollapsingMergeTree`](/es/reference/engines/table-engines/mergetree-family/collapsingmergetree).
</Warning>

`filter_expr` debe ser de tipo `UInt8`. La consulta elimina las filas de la tabla para las que esta expresión toma un valor distinto de cero.

Una consulta puede contener varios comandos separados por comas.

La cláusula `IN PARTITION` limita la mutación a las particiones enumeradas. Sin ella, en tablas de la familia `ReplicatedMergeTree`, cuando está habilitada la configuración [optimize\_mutations\_with\_partition\_pruning](/es/reference/settings/session-settings/optimize) (de forma predeterminada), ClickHouse detecta automáticamente las condiciones de la clave de partición en `filter_expr` y solo muta las particiones afectadas. En tablas `MergeTree` no replicadas, use una cláusula `IN PARTITION` explícita para limitar la mutación a particiones específicas.

La sincronía del procesamiento de la consulta se define mediante la configuración [mutations\_sync](/es/reference/settings/session-settings/mutations#mutations_sync). De forma predeterminada, es asíncrona.

**Véase también**

* [Mutaciones](/es/reference/statements/alter/index#mutations)
* [Sincronía de las consultas ALTER](/es/reference/statements/alter/index#synchronicity-of-alter-queries)
* Configuración [mutations\_sync](/es/reference/settings/session-settings/mutations#mutations_sync)

## Contenido relacionado

* Blog: [Cómo gestionar actualizaciones y eliminaciones en ClickHouse](https://clickhouse.com/blog/handling-updates-and-deletes-in-clickhouse)