07 Criar um dashboard ao vivo com seus dados
Execute no seu notebook um dashboard em container conectado ao seu serviço do ClickHouse Cloud e observe o tempo da consulta e as linhas lidas mudarem conforme você aplica filtros.
Quer sentir a velocidade? Execute no seu notebook um pequeno dashboard que consulta a tabela
forex no seu serviço do ClickHouse Cloud. Ele desenha gráficos interativos de candles e
volume e, sempre que você altera um filtro, mostra o tempo da consulta no ClickHouse e quantas
linhas foram lidas — geralmente em poucos milissegundos. Esse é o objetivo: mude o par, arraste o
intervalo de datas e veja os dados voltarem imediatamente.
Por que Docker?
A aplicação roda dentro de um container Docker com sua própria versão fixa do Python; por isso, não importa qual Python você tenha instalado — ou se não tiver nenhum. Você só precisa do Docker.
Etapa 1 — Instalar o Docker
Se ainda não o tiver, instale o
Docker Desktop e inicie-o. Ele inclui o comando
docker compose usado abaixo. Confirme que está em execução:
docker --versionEtapa 2 — Clonar o repositório
Clone o repositório do workshop e entre na pasta do dashboard:
git clone https://github.com/ClickHouse/ClickHouse_Demos.git
cd ClickHouse_Demos
cd "$(git rev-parse --show-toplevel)/workshop_public/RTA-mini-workshop/dashboard"Etapa 3 — Adicionar os dados de conexão
Copie o modelo para um arquivo .env real; depois, abra-o em qualquer editor de texto e preencha
os dados do seu serviço:
cp .env.example .env
# now edit .env and fill in the values belowEncontre esses valores no console do Cloud em Connect (menu à esquerda) → HTTPS:
| Variável | Valor a informar |
|---|---|
CLICKHOUSE_HOST | por exemplo, abc123.ap-southeast-1.aws.clickhouse.cloud — sem https:// e sem porta |
CLICKHOUSE_PORT | 8443 |
CLICKHOUSE_USER | default |
CLICKHOUSE_PASSWORD | a senha definida quando você criou o serviço |
CLICKHOUSE_DATABASE | o banco que contém forex (normalmente default) |
CLICKHOUSE_SECURE | true |
Etapa 4 — Executar
Construa e inicie o container. Na primeira execução, a imagem base e as dependências são baixadas (leva um ou dois minutos); depois disso, o início é imediato.
docker compose up --buildQuando ele indicar que está escutando na porta 8000, abra
http://localhost:8000 no navegador. Para encerrar mais tarde, use Ctrl-C.
O que experimentar
Troque o par de moedas, arraste o intervalo de datas ou use um botão de intervalo rápido — cada mudança consulta novamente o ClickHouse, e o indicador no canto superior direito mostra o novo tempo da consulta e as linhas lidas. Restrinja o intervalo a um único par e observe a leitura cair para poucos milhares de linhas e alguns milissegundos — é a chave de ordenação em ação, exatamente como no módulo 4.7.
Os dados não aparecem?
Uma faixa vermelha significa que a aplicação não consegue acessar o ClickHouse. Confira os
valores em .env: host sem https:// e sem porta, porta 8443; confirme também que sua tabela
forex foi carregada. As instruções completas de configuração e diagnóstico estão no
README.md do dashboard.
06 Perguntar em linguagem natural
Aponte o ClickHouse Agents para o serviço que você acabou de carregar e faça perguntas em linguagem natural — ele escreve o SQL, executa e desenha o gráfico.
08 Você terminou — e agora?
Como continuar usando a avaliação e quais alternativas usar se algo tiver dado errado no caminho.