07 Créer un tableau de bord en direct sur vos données
Exécutez sur votre ordinateur un tableau de bord conteneurisé connecté à votre propre service ClickHouse Cloud et observez l'évolution du temps de requête et des lignes parcourues selon les filtres.
Vous voulez ressentir la vitesse ? Exécutez sur votre ordinateur un petit tableau de bord qui
interroge la table forex de votre service ClickHouse Cloud. Il trace des graphiques interactifs
en chandeliers et en volumes et, à chaque changement de filtre, affiche le temps de requête
ClickHouse et le nombre de lignes parcourues — généralement quelques millisecondes. C'est tout
l'intérêt : changez la paire, déplacez la période et les données reviennent instantanément.
Pourquoi Docker ?
L'application s'exécute dans un conteneur Docker avec sa propre version figée de Python ; peu importe donc la version de Python installée — ou même son absence. Seul Docker est nécessaire.
Étape 1 — Installer Docker
Si vous ne l'avez pas encore, installez
Docker Desktop et démarrez-le. Il comprend la
commande docker compose utilisée ci-dessous. Vérifiez qu'il fonctionne :
docker --versionÉtape 2 — Cloner le dépôt
Clonez le dépôt de l'atelier et placez-vous dans le dossier du tableau de bord :
git clone https://github.com/ClickHouse/ClickHouse_Demos.git
cd ClickHouse_Demos
cd "$(git rev-parse --show-toplevel)/workshop_public/RTA-mini-workshop/dashboard"Étape 3 — Ajouter vos paramètres de connexion
Copiez le modèle dans un véritable fichier .env, puis ouvrez-le dans l'éditeur de votre choix et
renseignez les paramètres de votre service :
cp .env.example .env
# now edit .env and fill in the values belowVous trouverez ces valeurs dans la console Cloud sous Connect (menu de gauche) → HTTPS :
| Variable | Valeur à renseigner |
|---|---|
CLICKHOUSE_HOST | par exemple abc123.ap-southeast-1.aws.clickhouse.cloud — sans https:// et sans port |
CLICKHOUSE_PORT | 8443 |
CLICKHOUSE_USER | default |
CLICKHOUSE_PASSWORD | le mot de passe défini lors de la création du service |
CLICKHOUSE_DATABASE | la base contenant forex (généralement default) |
CLICKHOUSE_SECURE | true |
Étape 4 — Lancer l'application
Construisez et démarrez le conteneur. Lors du premier lancement, l'image de base et les dépendances sont téléchargées (une ou deux minutes) ; les lancements suivants sont immédiats.
docker compose up --buildLorsqu'il indique qu'il écoute sur le port 8000, ouvrez
http://localhost:8000 dans votre navigateur. Arrêtez-le ensuite avec Ctrl-C.
À essayer
Changez la paire de devises, déplacez la période ou cliquez sur un bouton de période rapide. Chaque modification relance une requête ClickHouse, et l'indicateur en haut à droite affiche le nouveau temps de requête et les lignes parcourues. Limitez la période à une seule paire et regardez le volume tomber à quelques milliers de lignes et quelques millisecondes : c'est la clé de tri à l'œuvre, exactement comme dans le module 4.7.
Aucune donnée ne s'affiche ?
Une bannière rouge signifie que l'application ne parvient pas à joindre ClickHouse. Vérifiez les
valeurs dans .env : hôte sans https:// ni port, port 8443 ; assurez-vous aussi que la table
forex est chargée. La configuration complète et les conseils de dépannage figurent dans le
README.md du tableau de bord.
06 Poser une question en langage naturel
Connectez ClickHouse Agents au service que vous venez de charger et posez des questions en langage naturel : il écrit le SQL, l'exécute et trace le graphique.
08 Vous avez terminé — et maintenant ?
Comment poursuivre avec votre essai et quelles solutions de secours utiliser si une étape a échoué.