Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

Instalar o ClickHouse no NixOS

ClickHouse está disponível no repositório Nixpkgs e pode ser instalado com o Nix no Linux e no macOS.

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"

Instale o ClickHouse com o Nix

Você pode usar o Nix para instalar o ClickHouse sem adicioná-lo permanentemente ao sistema:

# Instale a versão estável mais recente
nix shell nixpkgs#clickhouse

# Ou instale a versão LTS
nix shell nixpkgs#clickhouse-lts

Isso disponibiliza o binário clickhouse na sessão atual do shell.

  • O pacote nixpkgs#clickhouse fornece a versão estável mais recente.
  • O pacote nixpkgs#clickhouse-lts fornece a versão de suporte de longo prazo.
  • Ambos os pacotes funcionam no Linux e no macOS.

Instalação permanente

Para instalar o ClickHouse permanentemente no sistema:

Para usuários do NixOS, adicione isto ao configuration.nix:

environment.systemPackages = with pkgs; [
  clickhouse
];

Em seguida, reconstrua o sistema:

sudo nixos-rebuild switch

Para usuários que não usam NixOS, instale com o perfil do Nix:

# Instale a versão estável mais recente
nix profile install nixpkgs#clickhouse

# Ou instale a versão LTS
nix profile install nixpkgs#clickhouse-lts

Inicie o servidor ClickHouse

Após a instalação, você pode iniciar o servidor ClickHouse:

clickhouse-server

Por padrão, o servidor será iniciado com uma configuração básica e ficará escutando em localhost:9000.

Para uso em produção no NixOS, talvez seja interessante configurar o ClickHouse como um serviço do sistema. Consulte o manual do NixOS para ver as opções de configuração disponíveis.

Inicie o cliente ClickHouse

Para se conectar ao servidor ClickHouse, abra um novo terminal e execute:

clickhouse-client

Sobre o pacote Nix

O pacote ClickHouse no Nixpkgs inclui:

  • clickhouse-server - O servidor de banco de dados ClickHouse
  • clickhouse-client - O cliente de linha de comando para se conectar ao ClickHouse
  • clickhouse-local - Uma ferramenta para executar consultas SQL em arquivos locais
  • Outros utilitários do ClickHouse

Para mais informações sobre o pacote ClickHouse no Nixpkgs, visite:

Navigation