Pular para o conteúdo principal
Usuários do WindowsO ClickHouse roda nativamente em Linux e macOS. No Windows, execute estas etapas dentro do Windows Subsystem for Linux (WSL).
A ClickHouse CLI (clickhousectl) ajuda você a instalar e gerenciar versões locais do ClickHouse, iniciar servidores e executar consultas.
1

Instale a ClickHouse CLI

curl https://clickhouse.com/cli | sh
Um alias chctl também é criado automaticamente para sua conveniência.
2

Instale o ClickHouse

Instale a versão mais recente do ClickHouse e defina-a como padrão:
clickhousectl local use latest
local use instala a versão, caso ela ainda não esteja presente, define-a como padrão e cria um symlink clickhouse em ~/.local/bin (no seu PATH) para que você possa invocar diretamente o binário clickhouse. Assim, qualquer etapa posterior nesta documentação que execute um comando clickhouse funcionará sem alterações.Você também pode selecionar uma versão específica:
clickhousectl local use 26.5            # Latest 26.5.x.x
clickhousectl local use 26.5.2.39       # Exact version
Use vs installclickhousectl local use <version> instala uma versão e a define como padrão, atualizando o symlink clickhouse no seu PATH. Para baixar uma versão sem alterar a versão padrão nem atualizar o symlink, use clickhousectl local install <version>.
3

Inicie o clickhouse-server

clickhousectl local server start
O servidor é executado em segundo plano. Para verificar se ele está em execução:
clickhousectl local server list
4

Inicie o clickhouse-client

clickhousectl local client
Você verá algo assim:
ClickHouse client version 24.5.1.117 (official build).
Connecting to localhost:9000 as user default.
Connected to ClickHouse server version 24.5.1.

local-host :)
Agora você já pode começar a enviar comandos SQL ao ClickHouse!
O Quick Start orienta você nas etapas para criar tabelas e inserir dados.
Última modificação em 29 de junho de 2026