Instalar o ClickHouse usando arquivos tgz

Instalar o ClickHouse no MacOS

​

Instale o ClickHouse usando arquivos tgz

Recomenda-se usar arquivos tgz oficiais pré-compilados para todas as distribuições Linux em que não seja possível instalar pacotes deb ou 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 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. ​

   Baixe e instale a versão estável mais recente

   A versão necessária pode ser baixada com curl ou wget do repositório https://packages.clickhouse.com/tgz/. Depois disso, os arquivos baixados devem ser extraídos e instalados com os scripts de instalação.

   Abaixo está um exemplo de como instalar a versão estável mais recente.

   Para ambientes de produção, recomenda-se usar a versão stable mais recente. Você pode encontrar o número do lançamento nesta página do GitHub com o sufixo -stable.

3. ​

   Obtenha a versão mais recente do ClickHouse

   Obtenha a versão mais recente do ClickHouse no GitHub e armazene-a na variável LATEST_VERSION.

   LATEST_VERSION=$(curl -s https://raw.githubusercontent.com/ClickHouse/ClickHouse/master/utils/list-versions/version_date.tsv | \
       grep -Eo '[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+' | sort -V -r | head -n 1)
   export LATEST_VERSION
   
4. ​

   Detecte a arquitetura do seu sistema

   Detecte a arquitetura do sistema e defina a variável ARCH de acordo:

   case $(uname -m) in
     x86_64) ARCH=amd64 ;;         # Para processadores Intel/AMD de 64 bits
     aarch64) ARCH=arm64 ;;        # Para processadores ARM de 64 bits
     *) echo "Unknown architecture $(uname -m)"; exit 1 ;; # Encerra se a arquitetura não for compatível
   esac
   
5. ​

   Baixe os tarballs de cada componente do ClickHouse

   Baixe os tarballs de cada componente do ClickHouse. O loop tenta primeiro os pacotes específicos da arquitetura e, depois, recorre aos genéricos.

   for PKG in clickhouse-common-static clickhouse-common-static-dbg clickhouse-server clickhouse-client clickhouse-keeper
   do
     curl -fO "https://packages.clickhouse.com/tgz/stable/$PKG-$LATEST_VERSION-${ARCH}.tgz" \
       || curl -fO "https://packages.clickhouse.com/tgz/stable/$PKG-$LATEST_VERSION.tgz"
   done
   
6. ​

   Extraia e instale os pacotes

   Execute os comandos abaixo para extrair e instalar os seguintes pacotes:

   • clickhouse-common-static

   # Extrai e instala o pacote clickhouse-common-static
   tar -xzvf "clickhouse-common-static-$LATEST_VERSION-${ARCH}.tgz" \
     || tar -xzvf "clickhouse-common-static-$LATEST_VERSION.tgz"
   sudo "clickhouse-common-static-$LATEST_VERSION/install/doinst.sh"
   

   • clickhouse-common-static-dbg

   # Extrai e instala o pacote de símbolos de depuração
   tar -xzvf "clickhouse-common-static-dbg-$LATEST_VERSION-${ARCH}.tgz" \
     || tar -xzvf "clickhouse-common-static-dbg-$LATEST_VERSION.tgz"
   sudo "clickhouse-common-static-dbg-$LATEST_VERSION/install/doinst.sh"
   

   • clickhouse-server

   # Extrai e instala o pacote do servidor com configuração
   tar -xzvf "clickhouse-server-$LATEST_VERSION-${ARCH}.tgz" \
     || tar -xzvf "clickhouse-server-$LATEST_VERSION.tgz"
   sudo "clickhouse-server-$LATEST_VERSION/install/doinst.sh" configure
   sudo /etc/init.d/clickhouse-server start  # Inicia o servidor
   

   • clickhouse-client

   # Extrai e instala o pacote do cliente
   tar -xzvf "clickhouse-client-$LATEST_VERSION-${ARCH}.tgz" \
     || tar -xzvf "clickhouse-client-$LATEST_VERSION.tgz"
   sudo "clickhouse-client-$LATEST_VERSION/install/doinst.sh"