Há várias formas de excluir dados no ClickHouse, cada uma com suas próprias vantagens e características de desempenho. Selecione o método apropriado com base no seu modelo de dados e no volume de dados que você pretende excluir.
| Método | Sintaxe | Quando usar |
|---|
| Exclusão leve | DELETE FROM [table] | Use ao excluir pequenas quantidades de dados. As linhas são imediatamente filtradas de todas as consultas SELECT subsequentes, mas, a princípio, são apenas marcadas internamente como excluídas, sem serem removidas do disco. |
| Mutação de exclusão | ALTER TABLE [table] DELETE | Use quando os dados precisarem ser removidos do disco imediatamente (por exemplo, por questões de compliance). Afeta negativamente o desempenho de SELECT. |
| Truncar tabela | TRUNCATE TABLE [db.table] | Remove com eficiência todos os dados de uma tabela. |
| Remover partição | DROP PARTITION | Remove com eficiência todos os dados de uma partição. |
SELECT subsequentes. A remoção posterior dessas linhas excluídas ocorre durante ciclos naturais de merge e, assim, gera menos E/S. Como resultado, é possível que, por um período não especificado, os dados não sejam realmente excluídos do armazenamento, mas apenas marcados como excluídos. Se você precisar garantir que os dados sejam excluídos, considere o comando de mutação acima.
-- exclui todos os dados de 2018 com uma exclusão leve. Não recomendado.
DELETE FROM posts WHERE toYear(CreationDate) = 2018
DELETE leve também pode afetar negativamente o desempenho de consultas SELECT. O comando também não é compatível com tabelas com projeções.
Observe que uma mutação é usada na operação para marcar as linhas excluídas (adicionando uma coluna _row_exists), o que gera alguma E/S.
Em geral, as exclusões leves devem ser preferidas em vez de mutações se a existência dos dados excluídos em disco puder ser tolerada (por exemplo, em casos em que não há requisitos de conformidade). Essa abordagem ainda deve ser evitada se todos os dados precisarem ser excluídos.
Leia mais sobre exclusões leves.
As mutações de exclusão podem ser executadas com um comando ALTER TABLE ... DELETE, por exemplo.
-- exclui todos os dados de 2018 com uma mutation. Não recomendado.
ALTER TABLE posts DELETE WHERE toYear(CreationDate) = 2018
WHERE. Não há atomicidade nesse processo - as partes são substituídas por partes alteradas assim que ficam prontas, e uma consulta SELECT que comece a ser executada durante uma mutação verá dados de partes que já foram alteradas junto com dados de partes que ainda não foram alteradas. Os usuários podem acompanhar o andamento por meio da tabela system.mutations. Essas são operações intensivas de E/S e devem ser usadas com moderação, pois podem afetar o desempenho das consultas SELECT no cluster.
Leia mais sobre mutações de exclusão.
Se for necessário excluir todos os dados de uma tabela, use o comando TRUNCATE TABLE mostrado abaixo. Esta é uma operação simples.
Saiba mais sobre TRUNCATE TABLE.
Se você especificou uma chave de particionamento personalizada para seus dados, as partições podem ser removidas com eficiência. Evite particionamento com alta cardinalidade.
ALTER TABLE posts (DROP PARTITION '2008')
Última modificação em 10 de junho de 2026
