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

> Documentation de l’instruction ALTER TABLE ... DELETE

# Instruction ALTER TABLE ... DELETE

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

Supprime les données correspondant à l’expression de filtrage spécifiée. Cette opération est implémentée sous forme de [mutation](/fr/reference/statements/alter/index#mutations).

<Warning>
  Le préfixe `ALTER TABLE` indique qu’il s’agit d’une opération lourde, contrairement à des requêtes similaires dans les bases de données OLTP. `ALTER TABLE ... DELETE` réécrit chaque partie de données contenant des lignes correspondant à l’expression de filtrage, ce qui génère d’importantes E/S d’écriture. Utilisez-la avec parcimonie, car elle peut affecter les performances de `SELECT`.

  Pour les tables `MergeTree`, envisagez d’utiliser la [requête `DELETE FROM`](/fr/reference/statements/delete), qui effectue une suppression légère et peut être nettement plus rapide. Pour les charges de travail nécessitant des suppressions ou des corrections fréquentes, envisagez d’utiliser [`ReplacingMergeTree`](/fr/concepts/features/operations/update/replacing-merge-tree) ou [`CollapsingMergeTree`](/fr/reference/engines/table-engines/mergetree-family/collapsingmergetree).
</Warning>

Le `filter_expr` doit être de type `UInt8`. La requête supprime les lignes de la table pour lesquelles cette expression prend une valeur non nulle.

Une requête peut contenir plusieurs commandes séparées par des virgules.

Le mode de synchronisation du traitement de la requête est défini par le paramètre [mutations\_sync](/fr/reference/settings/session-settings/mutations#mutations_sync). Par défaut, il est asynchrone.

**Voir aussi**

* [Mutations](/fr/reference/statements/alter/index#mutations)
* [Synchronisation des requêtes ALTER](/fr/reference/statements/alter/index#synchronicity-of-alter-queries)
* paramètre [mutations\_sync](/fr/reference/settings/session-settings/mutations#mutations_sync)

<div id="related-content">
  ## Contenu connexe
</div>

* Blog : [Gérer les mises à jour et les suppressions dans ClickHouse](https://clickhouse.com/blog/handling-updates-and-deletes-in-clickhouse)