01 ClickHouse Cloud

Document d’accompagnement du formateur pour la leçon participant 01 ClickHouse Cloud.

Durée

Environ 15 minutes. L’amorçage depuis le stockage objet demande de lancer l’opération puis d’attendre ; poursuivez vos explications pendant le chargement.

Trame d’animation

• C’est le premier effet « waouh » et la première fois que les tableaux de bord affichent des données : le tableau de bord Historical, alimenté par la table ClickHouse d’environ 3 millions de lignes qui vient d’être amorcée, renvoie en bien moins d’une seconde des agrégations portant sur de larges plages.
• Expliquez pourquoi ClickHouse est rapide pour ce type de requête (stockage en colonnes, analyses alignées sur ORDER BY) à un niveau adapté au public.
• À FAIRE : développer.

Problèmes courants

• La personne n’a pas copié le mot de passe du service (affiché une seule fois) ; elle doit le réinitialiser dans la console.
• Valeur incorrecte pour CLICKHOUSE_HOST (une URL complète avec schéma et port a été collée au lieu du simple nom d’hôte). CLICKHOUSE_PORT=8443 et CLICKHOUSE_SECURE=true sont des paramètres distincts.
• Le chargement d’amorçage échoue lors de l’accès au stockage objet ; vérifiez l’URL TLC publique.
• Référence de la répétition : l’application du schéma et de l’amorçage d’un mois a pris environ 12 s et produit 265 zones et environ 3,17 millions de trajets. Avant l’amorçage, l’application s’affiche vide, sans erreur (l’état non amorcé est pris en charge) : un tableau de bord vide à ce stade est donc normal, ce n’est pas un échec. Résultat confirmé lors de la répétition en environnement vierge de juillet 2026.

Procédures de réinitialisation

• Générez un nouveau mot de passe du service depuis la console, renseignez de nouveau .env.workshop, puis redémarrez : docker compose --env-file .env.workshop -f docker-compose.workshop.yml up -d.
• Recopiez la commande complète de création du schéma depuis le module participant 01, étape 2 ; elle est idempotente.