Pular para o conteúdo principal
Chartbrew é uma plataforma de visualização de dados que permite criar dashboards e monitorar dados em tempo real. Ela oferece suporte a várias fontes de dados, incluindo ClickHouse, e fornece uma interface sem código para criar gráficos e relatórios.

​
Objetivo

Neste guia, você vai conectar o Chartbrew ao ClickHouse, executar uma consulta SQL e criar uma visualização. Ao final, seu dashboard poderá ficar parecido com este:
Adicione alguns dadosSe você não tiver um dataset para usar, poderá adicionar um dos exemplos. Este guia usa o dataset UK Price Paid.

​
1. Reúna os dados da conexão

Para se conectar ao ClickHouse via HTTP(S), você precisa das seguintes informações: Os detalhes do seu serviço do ClickHouse Cloud estão disponíveis no console do ClickHouse Cloud. Selecione um serviço e clique em Connect: Escolha HTTPS. Os detalhes de conexão são exibidos em um comando curl de exemplo. Se você estiver usando ClickHouse autogerenciado, os detalhes de conexão são definidos pelo administrador do seu ClickHouse.

​
2. Conecte o Chartbrew ao ClickHouse

  1. Faça login no Chartbrew e acesse a aba Connections.
  2. Clique em Create connection e selecione ClickHouse entre as opções de banco de dados disponíveis.
  3. Insira os detalhes de conexão do seu banco de dados ClickHouse:
    • Display Name: Um nome para identificar a conexão no Chartbrew.
    • Host: O hostname ou endereço IP do seu servidor ClickHouse.
    • Port: Normalmente, 8443 para conexões HTTPS.
    • Database Name: O banco de dados ao qual você deseja se conectar.
    • Username: Seu nome de usuário do ClickHouse.
    • Password: Sua senha do ClickHouse.
  4. Clique em Test connection para verificar se o Chartbrew consegue se conectar ao ClickHouse.
  5. Se o teste for bem-sucedido, clique em Save connection. O Chartbrew recuperará automaticamente o esquema do ClickHouse.

​
3. Crie um dataset e execute uma consulta SQL

  1. Clique no botão Criar dataset ou vá até a aba Datasets para criar um.
  2. Selecione a conexão do ClickHouse que você criou anteriormente.
Escreva uma consulta SQL para buscar os dados que você quer visualizar. Por exemplo, esta consulta calcula o preço médio pago por ano a partir do dataset uk_price_paid:
Clique em Run query para obter os dados. Se você não tiver certeza de como escrever a consulta, pode usar o assistente de IA do Chartbrew para gerar consultas SQL com base no esquema do seu banco de dados. Depois que os dados forem obtidos, clique em Configure dataset para definir os parâmetros da visualização.

​
4. Criar uma visualização

  1. Defina uma métrica (valor numérico) e uma dimensão (valor categórico) para sua visualização.
  2. Pré-visualize o dataset para garantir que os resultados da consulta estejam estruturados corretamente.
  3. Escolha um tipo de gráfico (por exemplo, gráfico de linhas, gráfico de barras, gráfico de pizza) e adicione-o ao seu dashboard.
  4. Clique em Complete dataset para finalizar a configuração.
Você pode criar quantos datasets quiser para visualizar diferentes aspectos dos seus dados. Com esses datasets, você pode criar vários dashboards para acompanhar diferentes métricas.

​
5. Automatize as atualizações de dados

Para manter seu dashboard atualizado, você pode programar atualizações automáticas dos dados:
  1. Clique no ícone de calendário ao lado do botão de atualização do dataset.
  2. Configure o intervalo de atualização (por exemplo, a cada hora, diariamente).
  3. Salve as configurações para ativar a atualização automática.

​
Saiba mais

Para mais detalhes, confira o post do blog sobre Chartbrew e ClickHouse.
Última modificação em 2 de julho de 2026