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

> Interrogez efficacement de très grands jeux de données, et analysez-les ou modélisez-les dans un environnement de notebook familier.

# Connecter ClickHouse à Deepnote

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

<a href="https://www.deepnote.com/" target="_blank">Deepnote</a> est un notebook collaboratif de données conçu pour aider les équipes à découvrir et à partager des analyses. En plus d’être compatible avec Jupyter, il fonctionne dans le cloud et vous offre un espace centralisé pour collaborer et travailler efficacement sur des projets de data science.

Ce guide suppose que vous disposez déjà d’un compte Deepnote et d’une instance ClickHouse en fonctionnement.

<div id="interactive-example">
  ## Exemple interactif
</div>

Si vous souhaitez explorer un exemple interactif d’interrogation de ClickHouse à partir de notebooks Deepnote, cliquez sur le bouton ci-dessous pour lancer un modèle de projet connecté au [ClickHouse playground](/fr/get-started/sample-datasets/playground).

[<img src="https://deepnote.com/buttons/launch-in-deepnote.svg" alt="Lancer dans Deepnote" width="32" />](https://deepnote.com/launch?template=ClickHouse%20and%20Deepnote)

<div id="connect-to-clickhouse">
  ## Se connecter à ClickHouse
</div>

1. Dans Deepnote, sélectionnez la vue d’ensemble « Integrations », puis cliquez sur la vignette ClickHouse.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/OjlyQCBF1Nqq9S7v/images/integrations/data-visualization/deepnote_01.png?fit=max&auto=format&n=OjlyQCBF1Nqq9S7v&q=85&s=acbd3a65f572e1f0f55ae21088b0f7c4" alt="Vignette d’intégration ClickHouse" border width="3024" height="1368" data-path="images/integrations/data-visualization/deepnote_01.png" />

2. Saisissez les informations de connexion de votre instance ClickHouse :

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-8c05c8a2/Yn9Ty-XK2U8NF3YT/images/_snippets/cloud-connect-button.png?fit=max&auto=format&n=Yn9Ty-XK2U8NF3YT&q=85&s=b686c12ce9557c68eca40985010c95e0" 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-8c05c8a2/Yn9Ty-XK2U8NF3YT/images/_snippets/connection-details-https.png?fit=max&auto=format&n=Yn9Ty-XK2U8NF3YT&q=85&s=8791490ebb8e7ab70bff1b5b8b3e39e8" 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.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/OjlyQCBF1Nqq9S7v/images/integrations/data-visualization/deepnote_02.png?fit=max&auto=format&n=OjlyQCBF1Nqq9S7v&q=85&s=e6a2fd6317cdb9483c7cb44aacfcdb2e" alt="Boîte de dialogue des détails de ClickHouse" border width="1827" height="1061" data-path="images/integrations/data-visualization/deepnote_02.png" />

***REMARQUE :*** Si votre connexion à ClickHouse est protégée par une IP Access List, vous devrez peut-être autoriser les adresses IP de Deepnote. Pour en savoir plus, consultez la [documentation de Deepnote](https://docs.deepnote.com/integrations/authorize-connections-from-deepnote-ip-addresses).

3. Félicitations ! Vous avez maintenant intégré ClickHouse à Deepnote.

<div id="using-clickhouse-integration">
  ## Utilisation de l’intégration ClickHouse.
</div>

1. Commencez par vous connecter à l’intégration ClickHouse à droite de votre notebook.

   <Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/OjlyQCBF1Nqq9S7v/images/integrations/data-visualization/deepnote_03.png?fit=max&auto=format&n=OjlyQCBF1Nqq9S7v&q=85&s=f6266d831b6585ded2ebfab4ba013a44" alt="ClickHouse details dialog" border width="3008" height="1086" data-path="images/integrations/data-visualization/deepnote_03.png" />

2. Créez ensuite un nouveau bloc de requête ClickHouse et interrogez votre base de données. Les résultats de la requête seront enregistrés dans un DataFrame et stockés dans la variable spécifiée dans le bloc SQL.

3. Vous pouvez également convertir n’importe quel [bloc SQL](https://docs.deepnote.com/features/sql-cells) existant en bloc ClickHouse.
