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

# Comment connecter votre catalogue Iceberg à ClickHouse Cloud

> Découvrez comment connecter ClickHouse Cloud à votre Data Catalog et interroger des tables Iceberg.

export const e_1 = undefined

export const e_0 = undefined

<a href="/docs/get-started/quickstarts/home" onClick={(e_0) => { e_0.preventDefault(); window.location.href = (window.location.pathname.startsWith('/docs') ? '/docs' : '') + '/get-started/quickstarts/home'; }} className="inline-flex items-center gap-1.5 text-sm text-gray-500 dark:text-zinc-500 hover:text-gray-900 dark:hover:text-[#fdff75] transition-colors font-normal no-underline"><svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" className="shrink-0"><path d="M19 12H5" /><path d="M12 19l-7-7 7-7" /></svg>All quickstarts</a>

<div className="mt-2 flex flex-wrap gap-2">
  <Badge size="lg" color="blue">Data warehousing</Badge>
  <Badge size="lg" color="orange">Cloud</Badge>
</div>

<div id="prerequisites">
  ## Prérequis
</div>

Avant de commencer ce guide de démarrage rapide, vous devez disposer de :

To successfully follow this guide, you'll need the following:

* A running ClickHouse Cloud service. If you don't have one yet, complete the [ClickHouse Cloud quick start](/docs/get-started/setup/cloud) first.

- D'un **lac de données compatible Iceberg**
- D'un **Data Lake Catalog** (URL + identifiants)
- Selon le type de catalogue de lac de données : des identifiants de stockage d'objets (par exemple, un stockage compatible S3)
- D'au moins une table Iceberg existante enregistrée dans le catalogue

Si vous n'avez pas encore de données dans votre catalogue Iceberg, vous pouvez importer ce jeu de données. Nous utiliserons pour la démonstration le jeu de données disponible ici.

<div id="what-youll-build">
  ## Ce que vous allez créer
</div>

Dans ce guide de démarrage rapide, vous allez :

* Vous connecter à un REST Catalog Iceberg dans ClickHouse Cloud
* Créer une base de données ClickHouse adossée à ce catalogue
* Interroger directement une table Iceberg existante depuis ClickHouse
* Vérifier que ClickHouse lit les données depuis votre lac de données

À la fin, ClickHouse Cloud sera connecté à votre catalogue Iceberg et vous pourrez exécuter des requêtes SQL sur des tables Iceberg sans copier les données.

<Steps titleSize="h3">
  <Step title="Créer une connexion DataLakeCatalog" id="create-a-datalakecatalog-connection">
    Dans cette étape, vous allez vous connecter à votre Data Lake Catalog dans ClickHouse Cloud.

    1. Ouvrez votre service ClickHouse Cloud.

    2. Accédez à **Data Sources → Connect to your Data Lake Catalog**.

    3. Sélectionnez votre Data Catalog dans la liste déroulante.

    4. Renseignez le formulaire avec vos identifiants et informations de connexion.
       Pour Unity Catalog, saisissez :

       * Open Table Format (Iceberg)
       * Nom de la base de données ClickHouse. Il s'agit du nom de la base de données ClickHouse depuis laquelle vous interrogerez vos tables Iceberg.
       * ID de l'espace de travail
       * Nom du catalogue Databricks
       * ID client
       * Secret client

       **insérer des images**

    5. Enregistrez le catalogue. Vous devriez maintenant voir le Data Catalog s'afficher dans votre page Data Sources avec le nombre de tables disponibles dans la base de données.
  </Step>

  <Step title="Interroger une table Iceberg" id="query-iceberg-table">
    Dans cette étape, vous allez interroger une table Iceberg depuis votre Data Catalog.

    1. En cliquant soit sur `Show Tables`, soit sur `SQL Console`, vous arriverez dans la console SQL
       avec votre nouvelle base de données matérialisée, connectée à votre lac de données. Si vous passez par `SQL Console`, changez la base de données dans la liste déroulante pour votre base de données Iceberg.
    2. Vous devriez voir une ou plusieurs tables Iceberg dans votre arborescence de fichiers. Exécutez cette requête :

    ```sql theme={null}
    select * from iceberg_database.`iceberg_db.your_table`
    ```

    3. ClickHouse renverra les lignes de votre table Iceberg.
  </Step>
</Steps>

<div id="next-steps">
  ## Étapes suivantes
</div>

Maintenant que vous êtes connecté à votre lac de données, vous pouvez essayer d’écrire une table Iceberg dans ClickHouse.

<Tip>
  Attention aux guillemets. ClickHouse ne prend pas en charge les espaces de noms en trois parties ; vous devez mettre votre `schema.table` entre guillemets.
</Tip>

<Frame caption="Check out the ClickHouse academy for on-demand and live training">
  <a href="https://learn.clickhouse.com/" target="_blank">
    <img src="https://mintcdn.com/private-7c7dfe99/EDr8ydtGBgFPOQea/images/academy.webp?fit=max&auto=format&n=EDr8ydtGBgFPOQea&q=85&s=27e92fc656183cc2f176211907a7aa49" alt="ClickHouse Academy — Master ClickHouse with expert-designed training for every skill level" width="560" noZoom data-path="images/academy.webp" />
  </a>
</Frame>

<div className="mt-8">
  <a href="/docs/get-started/quickstarts/home" onClick={(e_1) => { e_1.preventDefault(); window.location.href = (window.location.pathname.startsWith('/docs') ? '/docs' : '') + '/get-started/quickstarts/home'; }} className="inline-flex items-center gap-1.5 text-sm text-gray-500 dark:text-zinc-500 hover:text-gray-900 dark:hover:text-[#fdff75] transition-colors font-normal no-underline"><svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" className="shrink-0"><path d="M19 12H5" /><path d="M12 19l-7-7 7-7" /></svg>All quickstarts</a>
</div>