Clickhouse: Instalação do ClickHouse e Configuração de Usuários

Instalação do ClickHouse e Configuração de Usuários em Ambientes de Produção

O ClickHouse é um poderoso sistema de gerenciamento de banco de dados orientado a colunas, projetado para consultas analíticas de alta performance. Se você está considerando uma implantação de produção, é recomendável seguir os métodos de instalação oficiais e configurar adequadamente os usuários e permissões.

Passos para Instalação do ClickHouse em Sistemas Debian/Ubuntu

Para ambientes de produção no Debian ou Ubuntu, a melhor prática é utilizar pacotes .deb oficiais. Siga os passos abaixo para configurar o repositório e instalar o ClickHouse:

  1. Configurar o Repositório Debian

Primeiro, é necessário configurar o repositório oficial do ClickHouse. Execute os seguintes comandos no terminal:

sudo apt-get install -y apt-transport-https ca-certificates curl gnupg
curl -fsSL 'https://packages.clickhouse.com/rpm/lts/repodata/repomd.xml.key' | sudo gpg --dearmor -o /usr/share/keyrings/clickhouse-keyring.gpg

echo "deb [signed-by=/usr/share/keyrings/clickhouse-keyring.gpg] https://packages.clickhouse.com/deb stable main" | sudo tee /etc/apt/sources.list.d/clickhouse.list
sudo apt-get update
 

  1. Instalar o ClickHouse (Servidor e Cliente)

Com o repositório configurado, instale o servidor e o cliente do ClickHouse usando o comando abaixo:

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

  1. Iniciar o Servidor do ClickHouse

Após a instalação, inicie o servidor do ClickHouse com o comando:

sudo service clickhouse-server start
 

Em seguida, você pode conectar-se ao servidor usando o cliente:

clickhouse-client
 

Se você configurou uma senha, use:

clickhouse-client --password
 

Configuração de Usuários no ClickHouse

Ao contrário de outros bancos de dados que utilizam comandos SQL para criar e gerenciar usuários, o ClickHouse gerencia seus usuários e permissões através de arquivos de configuração.

  1. Arquivo de Configuração de Usuários

O arquivo de configuração de usuários normalmente está localizado em /etc/clickhouse-server/users.xml. Para criar e gerenciar usuários, edite este arquivo. Siga os passos abaixo:

  1. Abrir o Arquivo de Configuração

Use o editor de sua preferência (neste exemplo, utilizamos o vim):

sudo vim /etc/clickhouse-server/users.xml
 

  1. Adicionar um Novo Usuário

Dentro do arquivo users.xml, adicione as configurações do novo usuário. Por exemplo, para adicionar um usuário db com a senha db@123:

<users>
    <!-- Outros usuários já configurados -->

    <db>
        <password>db@123</password>
        <networks>
            <ip>::/0</ip> <!-- Permite acesso de qualquer endereço IP -->
        </networks>
        <profile>default</profile> <!-- Define o perfil do usuário -->
        <quota>default</quota> <!-- Define a cota do usuário -->
    </db>

</users>

Substitua db e db@123 pelos valores desejados e defina o tipo de mascara de rede na tag "ip". Essa configuração define o perfil e a cota do usuário, além das permissões de acesso baseadas em IP.

Alguns dos tipos de permissão de acesso IP utilizados são:

            <ip>::/0</ip> <!-- Permite acesso de qualquer endereço IPV6 -->
            <ip>0.0.0.0/0</ip> <!-- Permite acesso de qualquer endereço IPv4 -->

  1. Salvar e Sair do Editor

Se estiver usando o vim, pressione Esc, digite :wq e pressione Enter para salvar as alterações e sair do editor.

  1. Reiniciar o ClickHouse

Após editar o arquivo de configuração, reinicie o servidor do ClickHouse para aplicar as alterações:

sudo systemctl restart clickhouse-server

  1. Verificar Usuários Configurados

Para verificar os usuários e permissões configurados, você pode consultar diretamente o arquivo users.xml, já que algumas versões do ClickHouse podem não ter a tabela system.users disponível.

Conclusão

A instalação e configuração do ClickHouse podem ser personalizadas para se adequar às necessidades do seu ambiente de produção. Certifique-se de definir as permissões de rede adequadas para seus usuários, e revise as configurações de segurança antes de colocar o servidor em produção.

Essa abordagem garante uma instalação segura e escalável para lidar com grandes volumes de dados e consultas analíticas complexas.

 

 

Data de Publicação: 24-08-2024

Categoria: Clickhouse