Recomenda-se usar pacotes
deboficiais 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:
- 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.
- 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.
- 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- Você pode substituir
stableporltspara 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.Instale o ClickHouse server e o cliente
sudo apt-get install -y clickhouse-server clickhouse-clientInicie o ClickHouse
Para iniciar o ClickHouse server, execute:
sudo service clickhouse-server startPara iniciar o cliente ClickHouse, execute:
clickhouse-clientSe você configurou uma senha para o servidor, precisará executar:
clickhouse-client --passwordInstale o ClickHouse Keeper standalone
Para instalar o clickhouse-keeper em servidores do ClickHouse Keeper standalone, execute:
sudo apt-get install -y clickhouse-keeperHabilite e inicie o ClickHouse Keeper
sudo systemctl enable clickhouse-keeper
sudo systemctl start clickhouse-keeper
sudo systemctl status clickhouse-keeperPacotes
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. |