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:
- 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"
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-ltsIsso disponibiliza o binário clickhouse na sessão atual do shell.
- O pacote
nixpkgs#clickhousefornece a versão estável mais recente. - O pacote
nixpkgs#clickhouse-ltsfornece 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 switchPara 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-ltsInicie o servidor ClickHouse
Após a instalação, você pode iniciar o servidor ClickHouse:
clickhouse-serverPor 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-clientSobre o pacote Nix
O pacote ClickHouse no Nixpkgs inclui:
clickhouse-server- O servidor de banco de dados ClickHouseclickhouse-client- O cliente de linha de comando para se conectar ao ClickHouseclickhouse-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: