Instalar o ClickHouse em Debian/Ubuntu

Instale o ClickHouse em Debian/Ubuntu Linux

Recomenda-se usar pacotes deb oficiais pré-compilados para Debian ou Ubuntu.

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 armazenamento

   Para 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 do Debian

   Para instalar o ClickHouse, execute os comandos a seguir:

   # Instale os pacotes de pré-requisito
   sudo apt-get install -y apt-transport-https ca-certificates curl gnupg
   
   # Baixe a chave GPG do ClickHouse e armazene-a no keyring
   curl -fsSL 'https://packages.clickhouse.com/rpm/lts/repodata/repomd.xml.key' | sudo gpg --dearmor -o /usr/share/keyrings/clickhouse-keyring.gpg
   
   # Obtenha a arquitetura do sistema
   ARCH=$(dpkg --print-architecture)
   
   # Adicione o repositório do ClickHouse às fontes do apt
   echo "deb [signed-by=/usr/share/keyrings/clickhouse-keyring.gpg arch=${ARCH}] https://packages.clickhouse.com/deb stable main" | sudo tee /etc/apt/sources.list.d/clickhouse.list
   
   # Atualize as listas de pacotes do apt
   sudo apt-get update
   

   • Você pode substituir stable por lts para usar diferentes tipos de lançamento, conforme a sua necessidade.
   • Você pode baixar e instalar os pacotes manualmente em packages.clickhouse.com.

   
   

   Método antigo para instalar os pacotes deb em distribuições antigas

   # Instale os pacotes de pré-requisito
   sudo apt-get install apt-transport-https ca-certificates dirmngr
   
   # Adicione a chave GPG do ClickHouse para autenticar os pacotes
   sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD2B48D754
   
   # Adicione o repositório do ClickHouse às fontes do apt
   echo "deb https://packages.clickhouse.com/deb stable main" | sudo tee \
       /etc/apt/sources.list.d/clickhouse.list
       
   # Atualize as listas de pacotes do apt
   sudo apt-get update
   
   # Instale os pacotes do ClickHouse server e do cliente
   sudo apt-get install -y clickhouse-server clickhouse-client
   
   # Inicie o serviço do ClickHouse server
   sudo service clickhouse-server start
   
   # Inicie o cliente de linha de comando do ClickHouse
   clickhouse-client # ou "clickhouse-client --password" se você configurou uma senha.
   
3. ​

   Instale o ClickHouse server e o cliente

   sudo apt-get install -y clickhouse-server clickhouse-client
   
4. ​

   Inicie o ClickHouse

   Para iniciar o ClickHouse server, execute:

   sudo service clickhouse-server start
   

   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 ClickHouse server.

   Para instalar o clickhouse-keeper em servidores do ClickHouse Keeper standalone, execute:

   sudo apt-get 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
   

​

Pacotes

Os pacotes deb disponíveis estão detalhados abaixo:

Package	Description
clickhouse-common-static	Instala os arquivos binários compilados do ClickHouse.
clickhouse-server	Cria um link simbólico para clickhouse-server e instala a configuração padrão do servidor.
clickhouse-client	Cria um link simbólico para clickhouse-client e outras ferramentas relacionadas ao cliente, além de instalar os arquivos de configuração do cliente.
clickhouse-common-static-dbg	Instala os arquivos binários compilados do ClickHouse com informações de depuração.
clickhouse-keeper	Usado para instalar o ClickHouse Keeper em nós dedicados do ClickHouse Keeper. Se você estiver executando o ClickHouse Keeper no mesmo servidor que o ClickHouse server, não será necessário instalar este pacote. Instala o ClickHouse Keeper e os arquivos de configuração padrão do ClickHouse Keeper.

Se você precisar instalar uma versão específica do ClickHouse, deverá instalar todos os pacotes com a mesma versão: sudo apt-get install clickhouse-server=21.8.5.7 clickhouse-client=21.8.5.7 clickhouse-common-static=21.8.5.7