ClickHouse/docs/en/sql-reference/statements/alter/delete.md

sidebar_position	sidebar_label
39	DELETE

ALTER TABLE … DELETE Statement

ALTER TABLE [db.]table [ON CLUSTER cluster] DELETE WHERE filter_expr

Deletes data matching the specified filtering expression. Implemented as a mutation.

:::note
The ALTER TABLE prefix makes this syntax different from most other systems supporting SQL. It is intended to signify that unlike similar queries in OLTP databases this is a heavy operation not designed for frequent use. :::

The filter_expr must be of type UInt8. The query deletes rows in the table for which this expression takes a non-zero value.

One query can contain several commands separated by commas.

The synchronicity of the query processing is defined by the mutations_sync setting. By default, it is asynchronous.

See also

• Mutations
• Synchronicity of ALTER Queries
• mutations_sync setting