Pular para o conteúdo principal
Metabase é uma ferramenta de UI open source fácil de usar para fazer perguntas sobre seus dados. O Metabase é um aplicativo Java que pode ser executado simplesmente baixando o arquivo JAR e executando-o com java -jar metabase.jar. O Metabase se conecta ao ClickHouse usando um JDBC driver que você baixa e coloca na pasta plugins:

​
Objetivo

Neste guia, você fará algumas consultas aos seus dados no ClickHouse usando o Metabase e visualizará os resultados. Um dos resultados terá esta aparência:

Adicione alguns dadosSe você não tiver um conjunto de dados para usar, poderá adicionar um dos exemplos disponíveis. 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 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. Baixe o plugin do ClickHouse para o Metabase

  1. Se você não tiver uma pasta plugins, crie uma como subpasta no local em que o metabase.jar está salvo.
  2. O plugin é um arquivo JAR chamado clickhouse.metabase-driver.jar. Baixe a versão mais recente do arquivo JAR em https://github.com/clickhouse/metabase-clickhouse-driver/releases/latest
  3. Salve clickhouse.metabase-driver.jar na pasta plugins.
  4. Inicie (ou reinicie) o Metabase para que o driver seja carregado corretamente.
  5. Acesse o Metabase em http://hostname:3000. Na primeira inicialização, você verá uma tela de boas-vindas e terá que responder a uma série de perguntas. Se for solicitado a selecionar um banco de dados, selecione “Vou adicionar meus dados depois”:

​
3. Conecte o Metabase ao ClickHouse

  1. Clique no ícone de engrenagem no canto superior direito e selecione Configurações de administrador para acessar sua página de administração do Metabase.
  2. Clique em Adicionar um banco de dados. Como alternativa, você pode clicar na guia Bancos de dados e selecionar o botão Adicionar banco de dados.
  3. Se a instalação do driver tiver funcionado, você verá ClickHouse no menu suspenso de Tipo de banco de dados:
  4. Dê ao seu banco de dados um Nome de exibição, que é uma configuração do Metabase — portanto, use o nome que preferir.
  5. Insira os detalhes de conexão do seu banco de dados ClickHouse. Ative uma conexão segura se o servidor ClickHouse estiver configurado para usar SSL. Por exemplo:
  6. Clique no botão Salvar e o Metabase fará uma varredura no seu banco de dados em busca de tabelas.

​
4. Execute uma consulta SQL

  1. Saia das Configurações de administrador clicando no botão Sair do admin no canto superior direito.
  2. No canto superior direito, clique no menu + Novo e observe que você pode fazer perguntas, executar consultas SQL e criar um dashboard:
  3. Por exemplo, aqui está uma consulta SQL executada em uma tabela chamada uk_price_paid, que retorna o preço médio pago por ano de 1995 a 2022:

​
5. Faça uma pergunta

  1. Clique em + Novo e selecione Question. Observe que é possível criar uma pergunta começando por um banco de dados e uma tabela. Por exemplo, a pergunta a seguir é feita à tabela uk_price_paid no banco de dados default. Aqui está uma pergunta simples que calcula o preço médio por cidade no condado de Greater Manchester:
  2. Clique no botão Visualize para ver os resultados em formato de tabela.
  3. Abaixo dos resultados, clique no botão Visualization para mudar a visualização para um gráfico de barras (ou qualquer uma das outras opções disponíveis):

​
Saiba mais

Encontre mais informações sobre o Metabase e sobre como criar dashboards na documentação do Metabase.
Última modificação em 25 de junho de 2026