> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-a804b3ad.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Explo est un outil UI open source simple d’utilisation pour interroger vos données.

# Connecter Explo à ClickHouse

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>;
};

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

Des analyses orientées client pour n’importe quelle plateforme. Conçu pour de superbes visualisations. Pensé pour la simplicité.

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

Dans ce guide, vous allez connecter vos données depuis ClickHouse à Explo et visualiser les résultats. Le graphique se présentera ainsi :

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_15.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=61a721be4a2ed2117ff068bedd7165b3" size="md" alt="Tableau de bord Explo" width="1152" height="661" data-path="images/integrations/data-visualization/explo_15.png" />

<p />

<Tip>
  **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. Vous pouvez en consulter plusieurs autres dans cette même catégorie de la documentation.
</Tip>

<div id="1-gather-your-connection-details">
  ## 1. Rassemblez vos informations de connexion
</div>

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/daBhXl5XtKWCwD8z/images/_snippets/cloud-connect-button.png?fit=max&auto=format&n=daBhXl5XtKWCwD8z&q=85&s=82b4154e6a183c6abc449c7b38a5ba43" size="md" alt="Bouton Connect du service ClickHouse Cloud" border width="998" height="932" data-path="images/_snippets/cloud-connect-button.png" />

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/daBhXl5XtKWCwD8z/images/_snippets/connection-details-https.png?fit=max&auto=format&n=daBhXl5XtKWCwD8z&q=85&s=a87d49c2093eac2e430f5546349a4969" size="md" alt="Détails de connexion HTTPS ClickHouse Cloud" border width="1320" height="1184" data-path="images/_snippets/connection-details-https.png" />

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

<div id="2--connect-explo-to-clickhouse">
  ## 2.  Connecter Explo à ClickHouse
</div>

1. Créez un compte Explo.

2. Cliquez sur l’onglet **Data** d’Explo dans la barre latérale de gauche.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_01.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=52f1ea8cc1153a424bc44af071dd7af6" size="sm" alt="Onglet Data" border width="432" height="500" data-path="images/integrations/data-visualization/explo_01.png" />

3. Cliquez sur **Connect Data Source** en haut à droite.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_02.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=65c2d54f94ee5052c3162b4c2c216ca0" size="sm" alt="Connect Data Source" border width="288" height="78" data-path="images/integrations/data-visualization/explo_02.png" />

4. Renseignez les informations sur la page **Getting Started**

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_03.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=af13de33b519a898d1a588d01027cfa8" size="md" alt="Getting Started" border width="1152" height="894" data-path="images/integrations/data-visualization/explo_03.png" />

5. Sélectionnez **ClickHouse**

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_04.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=f1436deeac3a5b029fcfff0ba3799c8d" size="md" alt="ClickHouse" border width="1152" height="1156" data-path="images/integrations/data-visualization/explo_04.png" />

6. Saisissez vos **identifiants ClickHouse**.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_05.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=9d4049c3be76ce2d965b3e0879a417f5" size="md" alt="Identifiants" border width="1152" height="902" data-path="images/integrations/data-visualization/explo_05.png" />

7. Configurez **Security**

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_06.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=c7bde42a50d6ed484a67bfa166916b1c" size="md" alt="Security" border width="1152" height="855" data-path="images/integrations/data-visualization/explo_06.png" />

8. Dans ClickHouse, **ajoutez les adresses IP d’Explo à la liste blanche**.
   `54.211.43.19, 52.55.98.121, 3.214.169.94 et 54.156.141.148`

<div id="3-create-a-dashboard">
  ## 3. Créer un tableau de bord
</div>

1. Accédez à l’onglet **Dashboard** dans la barre de navigation de gauche.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_07.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=271cbd65eca9dcf3ef5dcaabbcaa38d3" size="sm" alt="Dashboard" border width="432" height="891" data-path="images/integrations/data-visualization/explo_07.png" />

2. Cliquez sur **Create Dashboard** dans le coin supérieur droit, puis donnez un nom à votre tableau de bord. Votre tableau de bord est maintenant créé !

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_08.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=17590dd4b73222f99d272bd08967acc3" size="sm" alt="Create Dashboard" border width="425" height="76" data-path="images/integrations/data-visualization/explo_08.png" />

3. Vous devriez maintenant voir un écran semblable à celui-ci :

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_09.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=07609c44938821cd95d5c080882d49ac" size="md" alt="Explo Dashboard" border width="1152" height="688" data-path="images/integrations/data-visualization/explo_09.png" />

<div id="4-run-a-sql-query">
  ## 4. Exécuter une requête SQL
</div>

1. Repérez le nom de votre table dans la barre latérale droite, sous le titre de votre schéma. Saisissez ensuite la commande suivante dans votre éditeur de jeu de données :
   `SELECT * FROM YOUR_TABLE_NAME
   LIMIT 100`

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_10.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=65e1016aecc293cf5d624f69ebc0a0a2" size="md" alt="Explo Dashboard" border width="1152" height="284" data-path="images/integrations/data-visualization/explo_10.png" />

2. Cliquez maintenant sur Run, puis ouvrez l’onglet Preview pour voir vos données.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_11.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=ca143f9a866d951aed9e4c29bd2d7570" size="md" alt="Explo Dashboard" border width="1152" height="329" data-path="images/integrations/data-visualization/explo_11.png" />

<div id="5-build-a-chart">
  ## 5. Créer un graphique
</div>

1. Depuis le panneau de gauche, faites glisser l’icône de l’histogramme sur l’écran.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_16.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=0529516cf4c84bd4b3fac3b3b56ba437" size="sm" alt="Explo Dashboard" border width="432" height="978" data-path="images/integrations/data-visualization/explo_16.png" />

2. Sélectionnez le jeu de données. Vous devriez maintenant voir un écran comme celui-ci :

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_12.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=ef24e493fb8a7513b4ef1acccb21256b" size="sm" alt="Explo Dashboard" border width="432" height="744" data-path="images/integrations/data-visualization/explo_12.png" />

3. Renseignez **county** sur l’axe X et **Price** dans la section de l’axe Y, comme suit :

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_13.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=fa1327718a4895ddd1eda424199f0680" size="sm" alt="Explo Dashboard" border width="432" height="754" data-path="images/integrations/data-visualization/explo_13.png" />

4. Changez ensuite l’agrégation en **AVG**.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_14.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=afa59410542bf185e652bcdcf58e4e31" size="sm" alt="Explo Dashboard" border width="432" height="447" data-path="images/integrations/data-visualization/explo_14.png" />

5. Nous avons maintenant le prix moyen des logements, ventilé par comté !

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_15.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=61a721be4a2ed2117ff068bedd7165b3" size="md" alt="Explo Dashboard" width="1152" height="661" data-path="images/integrations/data-visualization/explo_15.png" />

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

Pour en savoir plus sur Explo et sur la création de tableaux de bord, <a href="https://docs.explo.co/" target="_blank">consultez la documentation d’Explo</a>.
