> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Como conectar o Chartbrew ao ClickHouse
> Conecte o Chartbrew ao ClickHouse para criar dashboards em tempo real e relatórios para clientes.
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
export const CommunityMaintainedBadge = () => {
return ;
};
[Chartbrew](https://chartbrew.com) é uma plataforma de visualização de dados que permite criar dashboards e monitorar dados em tempo real. Ela oferece suporte a várias fontes de dados, incluindo ClickHouse, e fornece uma interface sem código para criar gráficos e relatórios.
## Objetivo
Neste guia, você vai conectar o Chartbrew ao ClickHouse, executar uma consulta SQL e criar uma visualização. Ao final, seu dashboard poderá ficar parecido com este:
**Adicione alguns dados**
Se você não tiver um dataset para usar, poderá adicionar um dos exemplos. Este guia usa o dataset [UK Price Paid](/docs/pt-BR/get-started/sample-datasets/uk-price-paid).
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.
1. Faça login no [Chartbrew](https://chartbrew.com/login) e acesse a aba **Connections**.
2. Clique em **Create connection** e selecione **ClickHouse** entre as opções de banco de dados disponíveis.
3. Insira os detalhes de conexão do seu banco de dados ClickHouse:
* **Display Name**: Um nome para identificar a conexão no Chartbrew.
* **Host**: O hostname ou endereço IP do seu servidor ClickHouse.
* **Port**: Normalmente, `8443` para conexões HTTPS.
* **Database Name**: O banco de dados ao qual você deseja se conectar.
* **Username**: Seu nome de usuário do ClickHouse.
* **Password**: Sua senha do ClickHouse.
4. Clique em **Test connection** para verificar se o Chartbrew consegue se conectar ao ClickHouse.
5. Se o teste for bem-sucedido, clique em **Save connection**. O Chartbrew recuperará automaticamente o esquema do ClickHouse.
1. Clique no botão **Create dataset** ou acesse a aba **Datasets** para criar um.
2. Selecione a conexão ClickHouse que você criou anteriormente.
Escreva uma consulta SQL para obter os dados que você deseja visualizar. Por exemplo, esta consulta calcula o preço médio pago por ano no dataset `uk_price_paid`:
```sql theme={null}
SELECT toYear(date) AS year, avg(price) AS avg_price
FROM uk_price_paid
GROUP BY year
ORDER BY year;
```
Clique em **Run query** para buscar os dados.
Se você não tiver certeza de como escrever a consulta, pode usar o **assistente de IA do Chartbrew** para gerar consultas SQL com base no esquema do seu banco de dados.
Assim que os dados forem obtidos, clique em **Configure dataset** para configurar os parâmetros da visualização.
1. Defina uma métrica (valor numérico) e uma dimensão (valor categórico) para sua visualização.
2. Visualize o dataset para garantir que os resultados da consulta estejam estruturados corretamente.
3. Escolha um tipo de gráfico (por exemplo, gráfico de linhas, gráfico de barras ou gráfico de pizza) e adicione-o ao seu dashboard.
4. Clique em **Complete dataset** para finalizar a configuração.
Você pode criar quantos datasets quiser para visualizar diferentes aspectos dos seus dados. Com esses datasets, você pode criar vários dashboards para acompanhar diferentes métricas.
Para manter seu dashboard atualizado, você pode agendar atualizações automáticas dos dados:
1. Clique no ícone de calendário ao lado do botão de atualização do dataset.
2. Configure o intervalo de atualização (por exemplo, a cada hora ou diariamente).
3. Salve as configurações para ativar a atualização automática.
## Saiba mais
Para mais detalhes, confira o post do blog sobre [Chartbrew e ClickHouse](https://chartbrew.com/blog/visualizing-clickhouse-data-with-chartbrew-a-step-by-step-guide/).
