Skip to main content
Metabase est un outil open source doté d’une interface utilisateur simple d’utilisation pour interroger vos données. Metabase est une application Java que vous pouvez exécuter simplement en téléchargeant le fichier JAR puis en le lançant avec java -jar metabase.jar. Metabase se connecte à ClickHouse à l’aide d’un pilote JDBC que vous téléchargez et placez dans le dossier plugins :

​
Objectif

Dans ce guide, vous allez poser quelques questions sur vos données ClickHouse avec Metabase et visualiser les réponses. L’une des réponses ressemblera à ceci :

Ajoutez des donnéesSi vous n’avez pas de jeu de données sur lequel travailler, vous pouvez en ajouter un à partir des exemples. Ce guide utilise le jeu de données UK Price Paid, vous pouvez donc choisir celui-ci. Plusieurs autres sont disponibles dans la même catégorie de documentation.
1

Rassemblez vos informations de connexion

Pour vous connecter à ClickHouse via HTTP(S), vous avez besoin des informations suivantes :Les informations de votre service ClickHouse Cloud sont disponibles dans la console ClickHouse Cloud. Sélectionnez un service, puis cliquez sur Connect :
Bouton Connect du service ClickHouse Cloud
Choisissez HTTPS. Les détails de connexion s’affichent dans un exemple de commande curl.
Détails de connexion HTTPS ClickHouse Cloud
Si vous utilisez ClickHouse autogéré, les détails de connexion sont définis par votre administrateur ClickHouse.
2

Téléchargez le plugin ClickHouse pour Metabase

  1. Si vous n’avez pas de dossier plugins, créez-en un dans le répertoire où se trouve metabase.jar.
  2. Le plugin est un fichier JAR nommé clickhouse.metabase-driver.jar. Téléchargez la dernière version du fichier JAR à l’adresse https://github.com/clickhouse/metabase-clickhouse-driver/releases/latest
  3. Enregistrez clickhouse.metabase-driver.jar dans votre dossier plugins.
  4. Démarrez (ou redémarrez) Metabase afin que le pilote soit correctement chargé.
  5. Accédez à Metabase à l’adresse http://hostname:3000. Au premier démarrage, vous verrez un écran d’accueil et devrez répondre à une série de questions. Si l’on vous demande de sélectionner une base de données, choisissez “J’ajouterai mes données plus tard” :
3

Connecter Metabase à ClickHouse

  1. Cliquez sur l’icône en forme d’engrenage en haut à droite, puis sélectionnez Paramètres d’administration pour accéder à votre page d’administration Metabase.
  2. Cliquez sur Ajouter une base de données. Vous pouvez également cliquer sur l’onglet Bases de données, puis sélectionner le bouton Ajouter une base de données.
  3. Si l’installation de votre pilote a fonctionné, ClickHouse apparaîtra dans le menu déroulant Type de base de données :
  4. Donnez à votre base de données un Nom d’affichage. Il s’agit d’un paramètre Metabase : vous pouvez donc utiliser le nom de votre choix.
  5. Saisissez les informations de connexion de votre base de données ClickHouse. Activez une connexion sécurisée si votre serveur ClickHouse est configuré pour utiliser SSL. Par exemple :
  6. Cliquez sur le bouton Enregistrer et Metabase analysera votre base de données à la recherche de tables.
4

Exécuter une requête SQL

  1. Quittez les Paramètres d’administration en cliquant sur le bouton Exit admin en haut à droite.
  2. En haut à droite, cliquez sur le menu + New et notez que vous pouvez poser des questions, exécuter des requêtes SQL et créer un dashboard :
  3. Par exemple, voici une requête SQL exécutée sur une table nommée uk_price_paid qui renvoie le prix moyen payé par année de 1995 à 2022 :
5

Poser une question

  1. Cliquez sur + New et sélectionnez Question. Notez que vous pouvez créer une question à partir d’une base de données et d’une table. Par exemple, la question suivante est posée à une table nommée uk_price_paid dans la base de données default. Voici une question simple qui calcule le prix moyen par ville, dans le comté du Grand Manchester :
  2. Cliquez sur le bouton Visualize pour afficher les résultats sous forme de tableau.
  3. Sous les résultats, cliquez sur le bouton Visualization pour remplacer la visualisation par un graphique en barres (ou toute autre option disponible) :

​
En savoir plus

Pour en savoir plus sur Metabase et sur la création de tableaux de bord, consultez la documentation de Metabase.
Dernière modification le 24 juillet 2026