01 ClickHouse Cloud

Material do facilitador correspondente à lição 01 ClickHouse Cloud do participante.

Cronograma

Cerca de 15 minutos. O carregamento inicial a partir do armazenamento de objetos pode rodar em segundo plano; inicie-o e continue a apresentação enquanto os dados são carregados.

Roteiro de apresentação

• Este é o primeiro momento de impacto e a primeira vez que os painéis exibem dados: o painel Historical, alimentado pela tabela do ClickHouse recém-preenchida com cerca de 3 milhões de linhas, retorna agregações de intervalos amplos em muito menos de um segundo.
• Explique por que o ClickHouse é rápido nesse formato de consulta (armazenamento colunar e varreduras alinhadas ao ORDER BY) em um nível adequado à turma.
• PENDENTE: expandir.

Falhas comuns

• O participante não copiou a senha do serviço (exibida uma única vez); será necessário redefini-la no console.
• CLICKHOUSE_HOST incorreto (foi colada uma URL completa, com esquema/porta, em vez de apenas o nome do host). CLICKHOUSE_PORT=8443 e CLICKHOUSE_SECURE=true são configurações separadas.
• O carregamento inicial falha ao acessar o armazenamento de objetos; confirme a URL pública do TLC.
• Referência do ensaio: o esquema e a carga inicial de um mês foram aplicados em cerca de 12 s e produziram 265 zonas e aproximadamente 3,17 milhões de viagens. Antes da carga inicial, o aplicativo é renderizado vazio, sem erro (o estado sem dados iniciais é tratado). Portanto, um painel vazio neste ponto é esperado, não uma falha. Comportamento confirmado no ensaio em ambiente limpo de julho de 2026.

Etapas de redefinição

• Emita uma nova senha do serviço no console, preencha novamente o .env.workshop e reinicie: docker compose --env-file .env.workshop -f docker-compose.workshop.yml up -d.
• Copie novamente o comando completo do esquema na etapa 2 do módulo 01 do participante; ele é idempotente.