Pular para o conteúdo principal
Se você não precisa instalar o ClickHouse em produção, pode executar um script de instalação com curl. O script identificará um binário adequado para o seu sistema operacional.
1

Instale o ClickHouse usando curl

Execute o comando abaixo para baixar um único binário para o seu sistema operacional.
No Linux e no macOS, isso também instala o clickhousectl em ~/.local/bin (com um link simbólico chctl) para que você possa gerenciar versões locais e servidores do ClickHouse.Para instalar apenas o binário clickhouse, sem o clickhousectl, defina CLICKHOUSE_ONLY=1:
Para usuários de Mac: se você estiver recebendo erros informando que o desenvolvedor do binário não pode ser verificado, consulte este artigo.
2

Inicie o clickhouse-local

O clickhouse-local permite processar arquivos locais e remotos usando a poderosa sintaxe SQL do ClickHouse, sem necessidade de configuração. Os dados da tabela são armazenados em um local temporário, o que significa que, após reiniciar o clickhouse-local, as tabelas criadas anteriormente não estarão mais disponíveis.Execute o comando abaixo para iniciar o clickhouse-local:
3

Inicie o clickhouse-server

Se quiser persistir os dados, execute o clickhouse-server. Você pode iniciar o servidor ClickHouse com o seguinte comando:
4

Inicie o clickhouse-client

Com o servidor em execução, abra uma nova janela do terminal e execute o comando abaixo para iniciar o clickhouse-client:
Você verá algo como isto:
Os dados da tabela são armazenados no diretório atual e continuarão disponíveis após reiniciar o servidor ClickHouse. Se necessário, você pode passar -C config.xml como argumento adicional de linha de comando para ./clickhouse server e fornecer configurações adicionais em um arquivo de configuração. Todas as configurações disponíveis estão documentadas aqui e no modelo de arquivo de configuração de exemplo.Agora você já pode começar a enviar comandos SQL ao ClickHouse!
O Quick Start orienta você nas etapas de criação de tabelas e inserção de dados.
Última modificação em 1 de julho de 2026