> ## 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.

# 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 <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

export const CommunityMaintainedBadge = () => {
  return <div className="CommunityMaintainedBadge">
            <div className="CommunityMaintainedIcon">
            <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="currentColor" viewBox="0 0 256 256">
                <path d="M244.8,150.4a8,8,0,0,1-11.2-1.6A51.6,51.6,0,0,0,192,128a8,8,0,0,1-7.37-4.89,8,8,0,0,1,0-6.22A8,8,0,0,1,192,112a24,24,0,1,0-23.24-30,8,8,0,1,1-15.5-4A40,40,0,1,1,219,117.51a67.94,67.94,0,0,1,27.43,21.68A8,8,0,0,1,244.8,150.4ZM190.92,212a8,8,0,1,1-13.84,8,57,57,0,0,0-98.16,0,8,8,0,1,1-13.84-8,72.06,72.06,0,0,1,33.74-29.92,48,48,0,1,1,58.36,0A72.06,72.06,0,0,1,190.92,212ZM128,176a32,32,0,1,0-32-32A32,32,0,0,0,128,176ZM72,120a8,8,0,0,0-8-8A24,24,0,1,1,87.24,82a8,8,0,1,0,15.5-4A40,40,0,1,0,37,117.51,67.94,67.94,0,0,0,9.6,139.19a8,8,0,1,0,12.8,9.61A51.6,51.6,0,0,1,64,128,8,8,0,0,0,72,120Z"></path>
            </svg>
        </div>
            Géré par la communauté
        </div>;
};

<CommunityMaintainedBadge />

[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.

<div id="goal">
  ## Objectif
</div>

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 :

<Image img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/chartbrew_01.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=7976a96696512f77018ba05775788b7b" size="lg" alt="Tableau de bord Chartbrew" width="2400" height="1289" data-path="images/integrations/data-visualization/chartbrew_01.webp" />

<Tip>
  **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](/docs/fr/get-started/sample-datasets/uk-price-paid).
</Tip>

<Steps>
  <Step title="Rassemblez vos informations de connexion" id="1-gather-your-connection-details">
    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** :

    <div className="ch-image-md">
      <Frame>
        <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=ec0a298a33ca841e947fa5e8bae47362" alt="Bouton Connect du service ClickHouse Cloud" width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />
      </Frame>
    </div>

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

    <div className="ch-image-md">
      <Frame>
        <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=cb0fbd98aa2b5b7ca484c9f53395ee07" alt="Détails de connexion HTTPS ClickHouse Cloud" width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />
      </Frame>
    </div>

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

  <Step title="Connecter Chartbrew à ClickHouse" id="2-connect-chartbrew-to-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.

           <Image img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/chartbrew_02.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=4131cc42b6327105fb22d11dfcd32929" size="lg" alt="Sélectionner une connexion ClickHouse dans Chartbrew" width="1600" height="1132" data-path="images/integrations/data-visualization/chartbrew_02.webp" />

    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.

           <Image img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/chartbrew_03.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=69925fe1dfdb2ef8377a2c46c7ca3a18" size="lg" alt="Paramètres de connexion ClickHouse dans Chartbrew" width="1600" height="1141" data-path="images/integrations/data-visualization/chartbrew_03.webp" />

    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.

           <Image img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/chartbrew_04.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=8f67660c923c5227096da4c7e038db9c" size="lg" alt="Schéma JSON ClickHouse dans Chartbrew" width="1600" height="855" data-path="images/integrations/data-visualization/chartbrew_04.webp" />
  </Step>

  <Step title="Créer un jeu de données et exécuter une requête SQL" id="3-create-a-dataset-and-run-a-sql-query">
    1. Cliquez sur le bouton **Créer un 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.

    <Image img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/chartbrew_05.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=d064adfea3e39be056cdb16f7adf8e30" size="lg" alt="Sélectionner une connexion ClickHouse pour le jeu de données" width="1600" height="725" data-path="images/integrations/data-visualization/chartbrew_05.webp" />

    Rédigez une requête SQL pour récupérer les données que vous souhaitez visualiser. Par exemple, cette requête calcule le prix moyen payé pour chaque année à 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;
    ```

    <Image img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/chartbrew_07.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=5ddd5f1ffb71a65354cb00953bfccd01" size="lg" alt="Requête SQL ClickHouse dans Chartbrew" width="1600" height="928" data-path="images/integrations/data-visualization/chartbrew_07.webp" />

    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.

    <Image img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/chartbrew_06.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=bff62660b2e116aa5c642d312e3d487f" size="lg" alt="Assistant IA SQL ClickHouse dans Chartbrew" width="2400" height="1184" data-path="images/integrations/data-visualization/chartbrew_06.webp" />

    Une fois les données récupérées, cliquez sur **Configurer le jeu de données** pour définir les paramètres de visualisation.
  </Step>

  <Step title="Créer une visualisation" id="4-create-a-visualization">
    1. Définissez une métrique (valeur numérique) et une dimension (valeur catégorielle) pour votre visualisation.
    2. Affichez l’aperçu du jeu de données pour vous assurer que les résultats de la requête sont correctement structurés.
    3. Choisissez un type de graphique (par ex., graphique en courbes, graphique en barres, diagramme circulaire) et ajoutez-le à votre tableau de bord.
    4. Cliquez sur **Terminer le jeu de données** pour finaliser la configuration.

    <Image img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/chartbrew_08.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=ea7e3735656b4138e4687a38f32b2521" size="lg" alt="Tableau de bord Chartbrew avec des données ClickHouse" width="2400" height="1068" data-path="images/integrations/data-visualization/chartbrew_08.webp" />

    Vous pouvez créer autant de jeux de données que vous le souhaitez pour visualiser différents aspects de vos données. À l’aide de ces jeux de données, vous pouvez créer plusieurs tableaux de bord afin de suivre différentes métriques.

    <Image img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/chartbrew_01.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=7976a96696512f77018ba05775788b7b" size="lg" alt="Tableau de bord Chartbrew avec des données ClickHouse" width="2400" height="1289" data-path="images/integrations/data-visualization/chartbrew_01.webp" />
  </Step>

  <Step title="Automatiser les mises à jour des données" id="5-automate-data-updates">
    Pour garder votre tableau de bord à jour, vous pouvez planifier des mises à jour automatiques des données :

    1. Cliquez sur l’icône Calendrier à côté du bouton d’actualisation du jeu de données.
    2. Configurez l’intervalle de mise à jour (par ex., toutes les heures, tous les jours).
    3. Enregistrez les paramètres pour activer l’actualisation automatique.

    <Image img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/chartbrew_09.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=ffe9e46d7d16433d8e2f1c7f71266c62" size="lg" alt="Paramètres d’actualisation du jeu de données dans Chartbrew" width="1600" height="899" data-path="images/integrations/data-visualization/chartbrew_09.webp" />
  </Step>
</Steps>

<div id="learn-more">
  ## En savoir plus
</div>

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/).
