Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

Connecter Metabase à ClickHouse

Intégration partenaire

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 :

Visualisation Metabase sous forme de diagramme circulaire affichant des données de ClickHouse

Rassemblez vos informations de connexion

Pour vous connecter à ClickHouse via HTTP(S), vous avez besoin des informations suivantes :

Paramètre(s) Description
HOST and PORT En général, le port est 8443 lors de l’utilisation de TLS, ou 8123 sans TLS.
DATABASE NAME Par défaut, une base de données nommée default est disponible ; utilisez le nom de la base de données à laquelle vous voulez vous connecter.
USERNAME and PASSWORD Par défaut, le nom d’utilisateur est default. Utilisez le nom d’utilisateur adapté à votre cas d’usage.

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.

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" :

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 :

    Sélection de base de données Metabase montrant ClickHouse comme option
  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 :

    Formulaire des informations de connexion Metabase pour la base de données ClickHouse
  6. Cliquez sur le bouton Enregistrer et Metabase analysera votre base de données à la recherche de tables.

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 :

    Menu + New de Metabase affichant les options pour créer des questions, exécuter des requêtes SQL et créer des dashboards
  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 :

    SQL Editor de Metabase affichant une requête sur les données UK price paid

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 :

    Interface de création de questions Metabase avec les données UK price paid
  2. Cliquez sur le bouton Visualize pour afficher les résultats sous forme de tableau.

    Visualisation Metabase affichant les résultats tabulaires des prix moyens par ville
  3. Sous les résultats, cliquez sur le bouton Visualization pour remplacer la visualisation par un graphique en barres (ou toute autre option disponible) :

    Visualisation Metabase en diagramme circulaire des prix moyens par ville dans le Grand Manchester

En savoir plus

Pour en savoir plus sur Metabase et sur la création de tableaux de bord, consultez la documentation de Metabase.

Navigation