> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-postgresql-tls-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Metabase é uma ferramenta de UI open source, fácil de usar, para fazer perguntas sobre seus dados.
# Conectando o Metabase ao ClickHouse
export const PartnerBadge = () => {
return ;
};
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
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 dados**
Se 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](/pt-BR/get-started/sample-datasets/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:
| Parâmetro(s) | Descrição |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `HOST` and `PORT` | Normalmente, a porta é 8443 ao usar TLS ou 8123 quando não se usa TLS. |
| `DATABASE NAME` | Por padrão, há um banco de dados chamado `default`; use o nome do banco de dados ao qual você deseja se conectar. |
| `USERNAME` and `PASSWORD` | Por padrão, o nome de usuário é `default`. Use o nome de usuário apropriado para o seu caso de uso. |
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](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](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.