> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Metabase est un outil d'interface utilisateur open source facile à utiliser pour interroger vos données.
# Connecter Metabase à ClickHouse
export const PartnerBadge = () => {
return ;
};
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
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](/fr/get-started/sample-datasets/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](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](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.