Skip to main content
Exclui os dados que correspondem à expressão de filtro especificada. Implementado como uma mutação.
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, 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 ou CollapsingMergeTree.
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 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. Por padrão, ela é assíncrona. Veja também

​
Conteúdo relacionado

Última modificação em 26 de setembro de 2026