Skip to main content
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 os detalhes da sua 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:
botão Connect do serviço do ClickHouse Cloud
Escolha HTTPS. Os detalhes de conexão são exibidos em um comando curl de exemplo.
detalhes de conexão HTTPS do ClickHouse Cloud
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 subpasta no local em que salvou o metabase.jar.
  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 que selecione um banco de dados, escolha “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 da 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 da administração 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 Pergunta. Observe que você pode criar uma pergunta começando com um banco de dados e uma tabela. Por exemplo, a pergunta a seguir é feita a uma tabela chamada 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 Visualizar para ver os resultados em formato de tabela.
  3. Abaixo dos resultados, clique no botão Visualização 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 24 de julho de 2026