> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.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-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_15.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=358e10822bedcdaff7031bd3ebde6ab3" 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-fbfa8bee/Qke-GQkmVyWEhvPu/images/_snippets/cloud-connect-button.png?fit=max&auto=format&n=Qke-GQkmVyWEhvPu&q=85&s=a41d53ce6c46ccccb2855331a8dcc841" 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-fbfa8bee/Qke-GQkmVyWEhvPu/images/_snippets/connection-details-https.png?fit=max&auto=format&n=Qke-GQkmVyWEhvPu&q=85&s=0377c34215bd524b359c0d20dd96bed3" 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-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_01.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=2b8befd0ad6f4f84ce545d639c3841bd" 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-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_02.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=f59691ee8b48672916dfab115715c002" 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-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_03.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=40147492e5d21af193ff3e0370d994d6" 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-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_04.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=f7d9330c2bea29ca4049eb80c72c1baf" 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-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_05.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=fff4edbdac9cfb92d3cf5c3412518993" 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-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_06.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=67f527737d9544798f54669363ef86d6" 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-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_07.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=fb2a0b629bbb4cdb53966b6b75fff589" 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-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_08.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=45bfe1a4f1e1aee253028e1a8fd6e389" 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-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_09.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=8f5b739f79f100fe72d9fb422967afee" 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-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_10.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=0777235055db63a24ddf13efa516c7da" 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-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_11.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=b0467229ca5f6012fdcbdffb25226662" 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-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_16.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=90b4a81ac793a8d5c6edec9ffda759ea" 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-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_12.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=1b085c463a9702ce95086e637c781df3" 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-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_13.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=0275751e33aaa27fa4f1fd0c755149b9" 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-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_14.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=6e01a23fb57792c32df8f4c8ac41788b" 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-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_15.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=358e10822bedcdaff7031bd3ebde6ab3" 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>.
