> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/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](/docs/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.
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.
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](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](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**" :
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.
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 :
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.
