Pular para o conteúdo principal
Apache Superset é uma plataforma open source de exploração e visualização de dados, escrita em Python. O Superset se conecta ao ClickHouse usando um driver em Python fornecido pelo ClickHouse. Vamos ver como isso funciona…

​
Objetivo

Neste guia, você vai criar um dashboard no Superset com dados de um banco de dados do ClickHouse. O dashboard ficará assim:
Adicione alguns dadosSe você não tiver um conjunto de dados para usar, pode adicionar um dos exemplos. Este guia usa o conjunto de dados UK Price Paid, então essa pode ser uma boa opção. Há vários outros para consultar na mesma categoria da documentação.

​
1. Reúna as 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. Instale o driver

  1. O Superset usa o driver clickhouse-connect para se conectar ao ClickHouse. Mais detalhes sobre o clickhouse-connect estão em https://pypi.org/project/clickhouse-connect/, e ele pode ser instalado com o seguinte comando:
Configuração do Docker ComposePara instalações baseadas em Docker, consulte o guia de configuração de banco de dados do Superset para ver instruções sobre como adicionar o clickhouse-connect ao seu contêiner.
  1. Inicie (ou reinicie) o Superset.

​
3. Conecte o Superset ao ClickHouse

  1. No Superset, selecione Data no menu superior e, em seguida, Databases no menu suspenso. Adicione um novo banco de dados clicando no botão + Database:

  1. Na primeira etapa, selecione ClickHouse Connect como o tipo de banco de dados:

  1. Na segunda etapa:
  • Ative ou desative o SSL.
  • Insira as informações de conexão que você coletou anteriormente.
  • Especifique o DISPLAY NAME: pode ser qualquer nome de sua preferência. Se você for se conectar a vários bancos de dados do ClickHouse, use um nome mais descritivo.

  1. Clique nos botões CONNECT e depois FINISH para concluir o assistente de configuração. Em seguida, você deverá ver seu banco de dados na lista de bancos de dados.

​
4. Adicionar um conjunto de dados

  1. Para interagir com seus dados do ClickHouse no Superset, você precisa definir um conjunto de dados. No menu superior do Superset, selecione Data e, em seguida, Datasets no menu suspenso.
  2. Clique no botão para adicionar um conjunto de dados. Selecione seu novo banco de dados como fonte de dados, e você verá as tabelas definidas no seu banco de dados:

  1. Clique no botão ADD na parte inferior da caixa de diálogo, e sua tabela aparecerá na lista de conjuntos de dados. Agora você está pronto para criar um dashboard e analisar seus dados do ClickHouse!

​
5. Criando gráficos e um dashboard no Superset

Se você já conhece o Superset, vai se sentir em casa nesta próxima seção. Se ainda não conhece, bem… ele é como muitas outras ferramentas legais de visualização por aí: não leva muito tempo para começar, mas os detalhes e nuances você aprende com o tempo, à medida que usa a ferramenta.
  1. Você começa com um dashboard. No menu superior do Superset, selecione Dashboards. Clique no botão no canto superior direito para adicionar um novo dashboard. O dashboard a seguir se chama UK property prices:

  1. Para criar um novo gráfico, selecione Charts no menu superior e clique no botão para adicionar um novo gráfico. Você verá várias opções. O exemplo a seguir mostra um gráfico Pie Chart usando o conjunto de dados uk_price_paid no menu suspenso CHOOSE A DATASET:

  1. Os gráficos de pizza do Superset precisam de uma Dimension e uma Metric; o restante das configurações é opcional. Você pode escolher seus próprios campos para a dimensão e a métrica; este exemplo usa o campo district do ClickHouse como dimensão e AVG(price) como métrica.

  1. Se você prefere gráficos de rosca a gráficos de pizza, pode definir isso e outras opções em CUSTOMIZE:

  1. Clique no botão SAVE para salvar o gráfico, depois selecione UK property prices no menu suspenso ADD TO DASHBOARD; em seguida, SAVE & GO TO DASHBOARD salva o gráfico e o adiciona ao dashboard:

  1. É isso. Criar dashboards no Superset com base em dados no ClickHouse abre todo um mundo de análises de dados extremamente rápidas!

Última modificação em 12 de junho de 2026