Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

Instalar o ClickHouse em Debian/Ubuntu

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

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"

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

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.

Instale o ClickHouse server e o cliente

sudo apt-get install -y clickhouse-server clickhouse-client

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

Instale o ClickHouse Keeper standalone

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

sudo apt-get install -y clickhouse-keeper

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.

Navigation