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

# Cómo conectar tu catálogo Iceberg en ClickHouse Cloud

> Aprende a conectar ClickHouse Cloud a tu catálogo de datos y a consultar tablas 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">almacén de datos</Badge>
  <Badge size="lg" color="orange">Cloud</Badge>
</div>

<div id="prerequisites">
  ## Prerrequisitos
</div>

Antes de empezar esta guía de inicio rápido, deberías tener:

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.

- Acceso a un **lago de datos compatible con Iceberg**
- **Catálogo del lago de datos** (URL + credenciales)
- Según el tipo de catálogo del lago de datos: credenciales de almacenamiento de objetos (por ejemplo, almacenamiento compatible con S3)
- Al menos una tabla Iceberg existente registrada en el catálogo

Si aún no tienes datos en tu catálogo Iceberg, puedes cargar este conjunto de datos. Usaremos el conjunto de datos de aquí para la demostración.

<div id="what-youll-build">
  ## Lo que crearás
</div>

En esta guía de inicio rápido, harás lo siguiente:

* Conectarte a un catálogo REST de Iceberg en ClickHouse Cloud
* Crear una base de datos de ClickHouse respaldada por ese catálogo
* Consultar una tabla Iceberg existente directamente desde ClickHouse
* Verificar que ClickHouse está leyendo datos de tu lago de datos

Al final, tendrás ClickHouse Cloud conectado a tu catálogo Iceberg y podrás ejecutar consultas SQL sobre tablas Iceberg sin copiar los datos.

<Steps titleSize="h3">
  <Step title="Crear una conexión a DataLakeCatalog" id="create-a-datalakecatalog-connection">
    En este paso, te conectarás a tu Catálogo del lago de datos en ClickHouse Cloud.

    1. Abre tu servicio de ClickHouse Cloud.

    2. Ve a **Data Sources â Connect to your Catálogo del lago de datos**.

    3. Selecciona tu catálogo de datos en el menú desplegable.

    4. Completa el formulario con tus credenciales y la información de conexión.
       Para Unity Catalog, introduce:

       * Open Table Format (Iceberg)
       * Nombre de la base de datos de ClickHouse. Este será el nombre de la base de datos de ClickHouse desde la que consultarás tus tablas Iceberg.
       * Workspace ID
       * Nombre del catálogo de Databricks
       * Client ID
       * Client Secret

       **insertar imágenes**

    5. Guarda el catálogo. Ahora deberías ver el catálogo de datos cargado en la página Data Sources, junto con el número de tablas disponibles en la base de datos.
  </Step>

  <Step title="Consultar una tabla Iceberg" id="query-iceberg-table">
    En este paso, consultarás una tabla Iceberg desde tu catálogo de datos.

    1. Ya sea haciendo clic en `Show Tables` o en `SQL Console`, llegarás a la consola SQL
       con tu nueva base de datos materializada y conectada a tu lago de datos. Si accedes a través de `SQL Console`, cambia el menú desplegable de bases de datos a tu base de datos Iceberg.
    2. Deberías ver una o más tablas Iceberg en tu árbol de archivos. Ejecuta esta consulta:

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

    3. ClickHouse devolverá las filas de tu tabla Iceberg.
  </Step>
</Steps>

<div id="next-steps">
  ## Próximos pasos
</div>

Ahora que te has conectado a tu lago de datos, puedes probar a escribir una tabla Iceberg en ClickHouse.

<Tip>
  Presta atención a las comillas. ClickHouse no admite espacios de nombres de tres partes; debes entrecomillar `schema.table`.
</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>
