O particionamento é especificado em uma tabela quando ela é definida inicialmente por meio da cláusula PARTITION BY. Essa cláusula pode conter uma expressão SQL sobre quaisquer colunas, cujo resultado definirá para qual partição uma linha será enviada.
As partes de dados são associadas logicamente a cada partição em disco e podem ser consultadas isoladamente. No exemplo abaixo, particionamos a tabela posts por ano usando a expressão toYear(CreationDate). Conforme as linhas são inseridas no ClickHouse, essa expressão é avaliada para cada linha, que é encaminhada para a partição resultante, caso ela exista (se a linha for a primeira de um ano, a partição será criada).
Leia sobre como definir a expressão de partição na seção Como definir a expressão de partição.
No ClickHouse, os usuários devem considerar o particionamento principalmente como um recurso de gerenciamento de dados, e não como uma técnica de otimização de consultas. Ao separar os dados logicamente com base em uma chave, cada partição pode ser manipulada de forma independente, por exemplo, excluída. Isso permite que os usuários movam partições e, assim, subconjuntos entre camadas de armazenamento com eficiência com base no tempo ou expirar dados/excluir do cluster com eficiência.
ALTER TABLE ... DROP PARTITION oferece uma forma econômica de remover uma partição inteira.
Esta consulta marca a partição como inativa e exclui os dados por completo em aproximadamente 10 minutos. A consulta é replicada — ela exclui os dados em todas as réplicas.
No exemplo abaixo, removemos posts de 2008 da tabela anterior excluindo a partição associada.
Última modificação em 10 de junho de 2026