01 ClickHouse Cloud

Material del facilitador correspondiente a la lección 01 ClickHouse Cloud del participante.

Tiempos

Unos 15 minutos. La carga inicial desde el almacenamiento de objetos puede ejecutarse en segundo plano; iníciala y sigue hablando mientras se cargan los datos.

Guion de presentación

• Este es el primer momento de impacto y la primera vez que los paneles muestran datos: el panel Historical, respaldado por la tabla de ClickHouse recién cargada con unos 3 millones de filas, devuelve agregaciones de intervalos amplios en mucho menos de un segundo.
• Explica por qué ClickHouse es rápido con este tipo de consulta (almacenamiento por columnas y lecturas alineadas con ORDER BY) a un nivel adecuado para el grupo.
• PENDIENTE: ampliar.

Fallos habituales

• El participante no copió la contraseña del servicio (solo se muestra una vez); debe restablecerla en la consola.
• CLICKHOUSE_HOST incorrecto (se pegó una URL completa con esquema y puerto, en lugar de solo el nombre de host). CLICKHOUSE_PORT=8443 y CLICKHOUSE_SECURE=true se configuran por separado.
• La carga inicial falla al acceder al almacenamiento de objetos; confirma la URL pública de TLC.
• Referencia del ensayo: el esquema y la carga inicial de un mes se aplicaron en unos 12 s y generaron 265 zonas y unos 3,17 millones de viajes. Antes de ejecutar la carga, la aplicación se muestra vacía, no con error (se controla el estado sin datos iniciales), por lo que un panel vacío en este punto es lo esperado, no un fallo. Confirmado en el ensayo en entorno limpio de julio de 2026.

Pasos de restablecimiento

• Vuelve a emitir la contraseña del servicio desde la consola, rellena de nuevo .env.workshop y reinicia: docker compose --env-file .env.workshop -f docker-compose.workshop.yml up -d.
• Copia de nuevo el comando completo del esquema desde el paso 2 del módulo 01 del participante; es idempotente.