> ## 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.
# Connecter Chartbrew à ClickHouse
> Connectez Chartbrew à ClickHouse pour créer des tableaux de bord en temps réel et des rapports clients.
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
export const CommunityMaintainedBadge = () => {
return ;
};
[Chartbrew](https://chartbrew.com) est une plateforme de visualisation de données qui vous permet de créer des tableaux de bord et de surveiller vos données en temps réel. Elle prend en charge plusieurs sources de données, dont ClickHouse, et fournit une interface no-code pour créer des graphiques et des rapports.
## Objectif
Dans ce guide, vous allez connecter Chartbrew à ClickHouse, exécuter une requête SQL et créer une visualisation. À la fin, votre tableau de bord devrait ressembler à ceci :
**Ajoutez des données**
Si vous n'avez pas de jeu de données à utiliser, 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).
## 1. Récupérez 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. Connecter Chartbrew à ClickHouse
1. Connectez-vous à [Chartbrew](https://chartbrew.com/login), puis accédez à l’onglet **Connexions**.
2. Cliquez sur **Créer une connexion** et sélectionnez **ClickHouse** parmi les bases de données disponibles.
3. Saisissez les informations de connexion de votre base de données ClickHouse :
* **Nom d’affichage** : nom permettant d’identifier la connexion dans Chartbrew.
* **Hôte** : nom d’hôte ou adresse IP de votre serveur ClickHouse.
* **Port** : généralement `8443` pour les connexions HTTPS.
* **Nom de la base de données** : base de données à laquelle vous souhaitez vous connecter.
* **Nom d’utilisateur** : votre nom d’utilisateur ClickHouse.
* **Mot de passe** : votre mot de passe ClickHouse.
4. Cliquez sur **Tester la connexion** pour vérifier que Chartbrew peut se connecter à ClickHouse.
5. Si le test réussit, cliquez sur **Enregistrer la connexion**. Chartbrew récupérera automatiquement le schéma de ClickHouse.
## 3. Créer un jeu de données et exécuter une requête SQL
1. Cliquez sur le bouton **Create jeu de données** ou accédez à l’onglet **Datasets** pour en créer un.
2. Sélectionnez la connexion ClickHouse que vous avez créée précédemment.
Rédigez une requête SQL pour extraire les données que vous souhaitez visualiser. Par exemple, cette requête calcule le prix moyen payé par an à partir du jeu de données `uk_price_paid` :
```sql theme={null}
SELECT toYear(date) AS year, avg(price) AS avg_price
FROM uk_price_paid
GROUP BY year
ORDER BY year;
```
Cliquez sur **Exécuter la requête** pour récupérer les données.
Si vous ne savez pas comment rédiger la requête, vous pouvez utiliser **l'assistant IA de Chartbrew** pour générer des requêtes SQL à partir du schéma de votre base de données.
Une fois les données récupérées, cliquez sur **Configurer le jeu de données** pour configurer les paramètres de la visualisation.
## 4. Créer une visualisation
1. Définissez une métrique (valeur numérique) et une dimension (valeur catégorielle) pour votre visualisation.
2. Prévisualisez le jeu de données pour vous assurer que le résultat de la requête est correctement structuré.
3. Choisissez un type de graphique (par exemple, graphique en courbes, histogramme, camembert) et ajoutez-le à votre tableau de bord.
4. Cliquez sur **Complete jeu de données** pour finaliser la configuration.
Vous pouvez créer autant de jeux de données que vous le souhaitez pour visualiser différents aspects de vos données. À partir de ces jeux de données, vous pouvez créer plusieurs tableaux de bord pour suivre différentes métriques.
## 5. Automatiser les mises à jour des données
Pour que votre tableau de bord reste à jour, vous pouvez planifier des mises à jour automatiques des données :
1. Cliquez sur l’icône de calendrier à côté du bouton d’actualisation du jeu de données.
2. Configurez l’intervalle de mise à jour (par exemple, toutes les heures ou tous les jours).
3. Enregistrez les paramètres pour activer l’actualisation automatique.
## En savoir plus
Pour en savoir plus, consultez l’article de blog sur [Chartbrew et ClickHouse](https://chartbrew.com/blog/visualizing-clickhouse-data-with-chartbrew-a-step-by-step-guide/).