Connecter Metabase à ClickHouse

Metabase est un outil d’interface utilisateur open source facile à utiliser pour interroger vos données.

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ées

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

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 :

Choisissez HTTPS. Les détails de connexion s’affichent dans un exemple de commande curl.

Si vous utilisez ClickHouse autogéré, les détails de connexion sont définis par votre administrateur ClickHouse.

​

2. Télécharger le plugin ClickHouse pour Metabase

1. Si vous n’avez pas de dossier plugins, créez-en un dans le même répertoire que 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 pour que le pilote soit correctement chargé.

5. Accédez à Metabase à l’adresse http://hostname:3000. Au premier démarrage, un écran de bienvenue s’affiche et vous devrez répondre à une série de questions. Si vous êtes invité à sélectionner une base de données, choisissez “I’ll add my data later” :

​

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 dans l’angle supérieur droit.

2. Dans l’angle supérieur droit, cliquez sur le menu + New et notez que vous pouvez poser des questions, exécuter des requêtes SQL et créer un tableau de bord :

3. Par exemple, voici une requête SQL exécutée sur une table appelé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 en partant d’une base de données et d’une table. Par exemple, la question suivante porte sur 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 choisir 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.