Conectando o Metabase ao ClickHouse

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.

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":

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.

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:

   

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):