Skip to main content
Databrain é uma plataforma de analytics embarcada que permite criar e compartilhar dashboards interativos, métricas e visualizações de dados com seus clientes. O Databrain se conecta ao ClickHouse por meio da interface HTTPS, facilitando a visualização e a análise dos seus dados no ClickHouse em uma interface moderna e fácil de usar.
Este guia mostrará as etapas para conectar o Databrain à sua instância do ClickHouse.

​
Pré-requisitos

  • Um banco de dados ClickHouse hospedado na sua própria infraestrutura ou no ClickHouse Cloud.
  • Uma conta do Databrain.
  • Um workspace do Databrain para conectar sua fonte de dados.

​
Etapas para conectar o Databrain ao ClickHouse

​
1. Reúna suas informações de 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. Permita os endereços IP da Databrain (se necessário)

Se a sua instância do ClickHouse tiver a filtragem de IP ativada, você precisará adicionar os endereços IP da Databrain à lista de permissões. Para usuários do ClickHouse Cloud:
  1. Acesse seu serviço no console do ClickHouse Cloud
  2. Vá para Settings → Security
  3. Adicione os endereços IP da Databrain à lista de permissões
Consulte a documentação da Databrain sobre whitelisting de IP para ver a lista atual de endereços IP que devem ser adicionados à lista de permissões.

​
3. Adicione o ClickHouse como fonte de dados no Databrain

  1. Faça login na sua conta do Databrain e acesse o workspace em que você deseja adicionar a fonte de dados.
  2. Clique em Data Sources no menu de navegação.
  1. Clique em Add a Data Source ou Connect Data Source.
  2. Selecione ClickHouse na lista de conectores disponíveis.
  1. Preencha os detalhes da conexão:
    • Destination Name: Insira um nome descritivo para esta conexão (por exemplo, “ClickHouse de produção” ou “Analytics DB”)
    • Host: Insira a URL do host do seu ClickHouse (por exemplo, https://your-instance.region.aws.clickhouse.cloud)
    • Port: Insira 8443 (porta HTTPS padrão do ClickHouse)
    • Username: Insira seu nome de usuário do ClickHouse
    • Password: Insira sua senha do ClickHouse
  1. Clique em Test Connection para verificar se o Databrain consegue se conectar à sua instância do ClickHouse.
  2. Quando a conexão for bem-sucedida, clique em Save ou Connect para adicionar a fonte de dados.

​
4. Configure as permissões do usuário

Certifique-se de que o usuário do ClickHouse com o qual você está se conectando tenha as permissões necessárias:
Substitua your_databrain_user e your_database pelo seu nome de usuário e pelo nome real do seu banco de dados.

​
Como usar o Databrain com ClickHouse

​
Explore seus dados

  1. Após a conexão, acesse seu workspace no Databrain.
  2. Você verá as tabelas do ClickHouse listadas no explorador de dados.
  1. Clique em uma tabela para explorar o schema e visualizar os dados.

​
Criar métricas e visualizações

  1. Clique em Create Metric para começar a criar visualizações a partir dos seus dados no ClickHouse.
  2. Selecione sua fonte de dados do ClickHouse e escolha a tabela que deseja visualizar.
  3. Use a interface intuitiva do Databrain para:
    • Selecionar dimensões e medidas
    • Aplicar filtros e agregações
    • Escolher tipos de visualização (gráficos de barras, gráficos de linhas, gráficos de pizza, tabelas etc.)
    • Adicionar consultas SQL personalizadas para análises avançadas
  4. Salve sua métrica para reutilizá-la em dashboards.

​
Criar dashboards

  1. Clique em Create Dashboard para começar a montar um dashboard.
  2. Adicione métricas ao seu dashboard arrastando métricas salvas.
  3. Personalize o layout e a aparência do seu dashboard.
  1. Compartilhe seu dashboard com sua equipe ou incorpore-o ao seu aplicativo.

​
Recursos avançados

O Databrain oferece vários recursos avançados para trabalhar com o ClickHouse:
  • SQL Console personalizada: Escreva e execute consultas SQL personalizadas diretamente no seu banco de dados ClickHouse
  • Multi-tenancy e single-tenancy: Conecte seu banco de dados ClickHouse em arquiteturas single-tenant e multi-tenant
  • Agendamento de relatórios: Agende relatórios automatizados e envie-os por e-mail para as partes interessadas
  • Insights com IA: Use IA para gerar resumos e insights a partir dos seus dados
  • Embedded Analytics: Incorpore dashboards e métricas diretamente aos seus aplicativos
  • Camada semântica: Crie modelos de dados reutilizáveis e lógica de negócios

​
Solução de problemas

​
Falha na conexão

Se você não conseguir se conectar ao ClickHouse:
  1. Verifique as credenciais: confira novamente seu nome de usuário, senha e URL do host
  2. Verifique a porta: certifique-se de usar a porta 8443 para HTTPS (ou 8123 para HTTP, se não estiver usando SSL)
  3. Lista de permissões de IP: confirme que os endereços IP do Databrain estão na lista de permissões nas configurações de firewall/segurança do ClickHouse
  4. SSL/TLS: certifique-se de que o SSL/TLS esteja configurado corretamente se você estiver usando HTTPS
  5. Permissões do usuário: verifique se o usuário tem permissões de SELECT em information_schema e nos bancos de dados de destino

​
Desempenho de consultas lentas

Se as consultas estiverem lentas:
  1. Otimize suas consultas: use filtros e agregações com eficiência
  2. Crie visões materializadas: para agregações acessadas com frequência, considere criar visões materializadas no ClickHouse
  3. Use tipos de dados apropriados: garanta que o schema do ClickHouse use os tipos de dados ideais
  4. Otimização de índices: aproveite as chaves primárias e os índices de omissão do ClickHouse

​
Saiba mais

Para mais informações sobre os recursos do Databrain e como criar análises avançadas:
Última modificação em 3 de julho de 2026