Pular para o conteúdo principal

Instalar o ClickHouse em distribuições baseadas em rpm

Recomenda-se usar os pacotes rpm oficiais pré-compilados para CentOS, RedHat e todas as outras distribuições Linux baseadas em rpm.
1

Revise as recomendações

Antes de instalar o ClickHouse, revise as seguintes recomendações:
  • Swap: Desative o arquivo de swap do sistema operacional em ambientes de produção.
  • Disk space: O binário do ClickHouse requer pelo menos 2,5 GB de espaço em disco para ser instalado.
  • Network: Para implantações distribuídas (clustering), use conectividade de rede de pelo menos 10 Gbit. A largura de banda da rede é fundamental para processar consultas distribuídas com grandes volumes de dados intermediários, bem como para a replicação.
Estimativa dos requisitos de armazenamentoPara estimar o espaço em disco necessário para seus dados:
  1. Estimate data volume: Pegue uma amostra dos seus dados e calcule o tamanho médio da linha; em seguida, multiplique pelo número de linhas que você pretende armazenar.
  2. Apply the compression coefficient: Carregue uma amostra no ClickHouse e compare o tamanho dos dados originais com o tamanho da tabela armazenada. Dados de clickstream, por exemplo, normalmente são comprimidos entre 6x e 10x.
  3. Account for replicas: Se você pretende armazenar dados em várias réplicas, multiplique o volume estimado pelo número de réplicas.
Para ver requisitos de hardware mais detalhados, consulte “Dimensionamento e recomendações de hardware”
2

Configure o repositório RPM

Adicione o repositório oficial executando o comando a seguir:
sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://packages.clickhouse.com/rpm/clickhouse.repo
Em sistemas com o gerenciador de pacotes zypper (openSUSE, SLES), execute:
sudo zypper addrepo -r https://packages.clickhouse.com/rpm/clickhouse.repo -g
sudo zypper --gpg-auto-import-keys refresh clickhouse-stable
Nas etapas abaixo, yum install pode ser substituído por zypper install, dependendo do gerenciador de pacotes que você estiver usando.
3

Instale o servidor e o cliente ClickHouse

Para instalar o ClickHouse, execute os seguintes comandos:
sudo yum install -y clickhouse-server clickhouse-client
  • Você pode substituir stable por lts para usar diferentes tipos de release, conforme sua necessidade.
  • Você pode baixar e instalar os pacotes manualmente em packages.clickhouse.com/rpm.
  • Para especificar uma versão específica, adicione -$version ao final do nome do pacote, por exemplo:
sudo yum install clickhouse-server-22.8.7.34
4

Inicie o servidor ClickHouse

Para iniciar o servidor ClickHouse, execute:
sudo systemctl enable clickhouse-server
sudo systemctl start clickhouse-server
sudo systemctl status clickhouse-server
Para iniciar o cliente ClickHouse, execute:
clickhouse-client
Se você configurou uma senha para o servidor, precisará executar:
clickhouse-client --password
5

Instale o ClickHouse Keeper standalone

Em ambientes de produção, recomendamos fortemente executar o ClickHouse Keeper em nós dedicados. Em ambientes de teste, se você decidir executar o ClickHouse Server e o ClickHouse Keeper no mesmo servidor, não será necessário instalar o ClickHouse Keeper, pois ele já está incluído no servidor ClickHouse.
Para instalar o clickhouse-keeper em servidores ClickHouse Keeper standalone, execute:
sudo yum install -y clickhouse-keeper
6

Habilite e inicie o ClickHouse Keeper

sudo systemctl enable clickhouse-keeper
sudo systemctl start clickhouse-keeper
sudo systemctl status clickhouse-keeper
Última modificação em 10 de junho de 2026