> ## 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 un catálogo de datos para tablas Iceberg o Delta en ClickHouse Cloud mediante la UI de fuentes de datos.

# Conectar un catálogo de datos en ClickHouse Cloud

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <span>Beta</span>
            </a>;
  }
  return <a href="https://clickhouse.com/docs/reference/settings/beta-and-experimental-features#beta-features" className="betaBadge">
            <span>Funcionalidad beta</span>
        </a>;
};

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

<BetaBadge />

Conecta ClickHouse Cloud a tus catálogos de datos para acceder a las tablas con formato de tabla abierto. Puedes configurar conexiones en la interfaz de usuario de **Fuentes de datos**. Para configurarlo mediante SQL, usa el motor de base de datos [`DataLakeCatalog`](/docs/es/reference/engines/database-engines/datalake) en el editor SQL que prefieras.

<Image img="https://mintcdn.com/private-7c7dfe99/NMEuR4JBQvfvT5BG/images/cloud/features/data-catalogs-ui.png?fit=max&auto=format&n=NMEuR4JBQvfvT5BG&q=85&s=23c85c7480fa5f37a9ab95aa2943fb10" size="md" alt="Interfaz de usuario de ClickHouse Cloud con integraciones de catálogos de datos" width="4944" height="2610" data-path="images/cloud/features/data-catalogs-ui.png" />

Una vez conectadas, las tablas del catálogo aparecen en la consola SQL bajo el nombre de base de datos que elijas. Puedes consultarlas con ClickHouse SQL estándar, combinarlas con tablas [MergeTree](/docs/es/reference/engines/table-engines/mergetree-family/mergetree) y usarlas como fuentes para [vistas materializadas](/docs/es/concepts/features/materialized-views).

<div id="prerequisites">
  ## Requisitos previos
</div>

Antes de conectar un catálogo, confirme lo siguiente:

* **Permisos del servicio.** Necesita el permiso `control-plane:service:manage` para acceder a la página **Fuentes de datos** y añadir catálogos.
* **Servicio en ejecución.** Si el servicio está inactivo, actívelo desde **Fuentes de datos** o desde las páginas de configuración del servicio antes de conectar o consultar catálogos vinculados.
* **Credenciales del catálogo.** Recopile los datos de conexión correspondientes a su tipo de catálogo antes de abrir el panel lateral. Cada catálogo utiliza campos y métodos de autenticación distintos; consulte [Añada la conexión de su catálogo](#add-your-catalog-connection) a continuación.

<div id="connect-your-catalog">
  ## Conecta tu catálogo
</div>

<Steps>
  <Step title="Abra el panel lateral del catálogo de datos" id="open-data-catalog-flyout">
    1. Selecciona **Fuentes de datos** en la barra de navegación izquierda.
    2. Haz clic en **+ Agregar catálogo** si aún no has configurado ninguna fuente de datos. De lo contrario, haz clic en **Agregar fuente de datos** > **Agregar catálogo de lago de datos**.
    3. En el panel lateral **Conecta tu catálogo de datos**, selecciona tu catálogo en el menú desplegable **Seleccionar catálogo**. Si el catálogo admite varios formatos de tabla abiertos, elige el formato en **Formato de tabla abierto**.

    <Image img="https://mintcdn.com/private-7c7dfe99/Z-ZVGWH-X46hMIiN/images/integrations/data-catalogs/catalog-flyout-select.png?fit=max&auto=format&n=Z-ZVGWH-X46hMIiN&q=85&s=d9db0300502c5a3504848e707b5030bd" alt="Panel lateral Conecta tu catálogo de datos con el menú desplegable Seleccionar catálogo que muestra AWS Glue, BigLake Metastore, Microsoft OneLake, Polaris, REST Catalog y Unity Catalog" size="lg" width="4490" height="2842" data-path="images/integrations/data-catalogs/catalog-flyout-select.png" />
  </Step>

  <Step title="Añade la conexión a tu catálogo" id="add-your-catalog-connection">
    Seleccione su catálogo a continuación para ver las indicaciones y los requisitos previos. Luego, complete los parámetros de conexión, junto con un **Nombre de base de datos**: la base de datos de ClickHouse que expone las tablas de su catálogo en la consola SQL.

    <Tabs>
      <Tab title="AWS Glue" id="aws-glue">
        [AWS Glue Catalog](/docs/es/guides/use-cases/data-warehousing/glue-catalog) expone tablas de [Iceberg](/docs/es/reference/engines/table-engines/integrations/iceberg) registradas en el Glue Data Catalog.

        Antes de conectarte, confirma lo siguiente:

        * ClickHouse versión 25.12 o posterior.
        * Las tablas Iceberg están registradas en AWS Glue Data Catalog en la región de destino.
        * Para la autenticación mediante clave de acceso, dispones de una clave de acceso de usuario de IAM con permisos para leer los metadatos de Glue y los objetos S3 subyacentes.
        * Para la autenticación mediante roles de IAM (26.2+), dispones de un rol de IAM que confía en el rol de servicio de ClickHouse. Incluye el ARN del rol de servicio de **Settings → Network security information** en la política de confianza del rol. Consulta [Acceso seguro a datos de Iceberg](/docs/es/products/cloud/guides/data-sources/accessing-iceberg-data-securely) para ver ejemplos de políticas de IAM.

        En el panel desplegable, introduce la **Region** de AWS (por ejemplo, `us-west-2`) y, a continuación, elige un método de autenticación:

        **Autenticación mediante clave de acceso**

        1. Selecciona **AWS Access Key** como **Authentication method**.
        2. Introduce tu **Access Key ID** y **Secret Access Key**.
        3. Introduce un **Database name** para la base de datos de ClickHouse que expone tus tablas de Glue.

        **Autenticación mediante roles de IAM (26.2+)**

        1. Selecciona **AWS IAM Role** como **Authentication method**.
        2. Copia el **Service role ID (IAM)** del panel desplegable y añádelo a la política de confianza de tu rol de IAM.
        3. Introduce tu **AWS Role ARN** y, de forma opcional, un **AWS Role Session Name**.
        4. Introduce un **Database name** para la base de datos de ClickHouse que expone tus tablas de Glue.

        <Note>
          Glue admite varios formatos de tabla, pero ClickHouse solo lee tablas de **Iceberg** desde Glue.
        </Note>
      </Tab>

      <Tab title="Unity Catalog (Iceberg)" id="unity-iceberg">
        Consulta tablas de [Iceberg](/docs/es/reference/engines/table-engines/integrations/iceberg) de Unity Catalog que utilizan ubicaciones de almacenamiento externo mediante credenciales de cliente OAuth de una entidad de servicio de Databricks. Consulta la [guía de Unity Catalog](/docs/es/guides/use-cases/data-warehousing/unity-catalog#read-iceberg) para obtener instrucciones completas de configuración.

        Antes de conectarte, confirma lo siguiente:

        * ClickHouse versión 25.12 o posterior.
        * [Unity Catalog está configurado para acceder a datos externos](https://docs.databricks.com/aws/en/external-access/admin).
        * Una [entidad de servicio](https://docs.databricks.com/aws/en/dev-tools/auth/oauth-m2m) de Databricks con un ID de cliente y un secreto de OAuth. La entidad de servicio tiene los privilegios `USE CATALOG`, `USE SCHEMA`, `USE EXTERNAL SCHEMA` y `SELECT` sobre las tablas que deseas consultar.

        En el panel desplegable:

        1. Introduce la **URL del espacio de trabajo** de Databricks (p. ej., `dbc-1234567a-cbde.cloud.databricks.com`).
        2. Introduce el **nombre del catálogo de Databricks** al que deseas conectarte (p. ej., `icebench`).
        3. Introduce el **ID de cliente** y el **secreto de cliente** de OAuth de tu entidad de servicio.
        4. Introduce un **nombre de base de datos** para la base de datos de ClickHouse que expone las tablas de Unity Catalog.
      </Tab>

      <Tab title="Unity Catalog (Delta)" id="unity-delta">
        Consulta tablas de [Delta Lake](/docs/es/reference/engines/table-engines/integrations/deltalake) en Unity Catalog que usan ubicaciones de almacenamiento externo mediante un token de acceso personal (PAT) de Databricks. Consulta la [guía de Unity Catalog](/docs/es/guides/use-cases/data-warehousing/unity-catalog#read-delta) para completar la configuración.

        Antes de conectarte, confirma lo siguiente:

        * ClickHouse versión 25.12 o posterior.
        * [Unity Catalog está configurado para acceder a datos externos](https://docs.databricks.com/aws/en/external-access/admin).
        * Un [token de acceso personal](https://docs.databricks.com/aws/en/dev-tools/auth/pat) de Databricks con al menos los permisos `EXTERNAL USE SCHEMA`, `USE CATALOG`, `USE SCHEMA` y `SELECT` en las tablas de destino.

        En el panel lateral:

        1. Introduce la **URL del workspace** de Databricks (por ejemplo, `dbc-1234567a-cbde.azuredatabricks.net`).
        2. Introduce el **nombre del catálogo de Databricks** al que quieres conectarte.
        3. Introduce tu **token de acceso personal**.
        4. Introduce un **nombre de base de datos** para la base de datos de ClickHouse que expone tus tablas Delta.

        <Note>
          Iceberg y Delta usan métodos de autenticación distintos en la UI. Para acceder a ambos tipos de tablas, se requieren dos bases de datos de ClickHouse independientes.
        </Note>
      </Tab>

      <Tab title="Catálogo REST" id="rest">
        Conéctese a cualquier catálogo que implemente la especificación [Iceberg REST Catalog](https://github.com/apache/iceberg/blob/main/open-api/rest-catalog-open-api.yaml). Consulte la [guía del catálogo REST](/docs/es/guides/use-cases/data-warehousing/rest-catalog) para ver la configuración completa.

        Antes de conectarse, confirme lo siguiente:

        * ClickHouse versión 25.12 o posterior.
        * Que se pueda acceder al endpoint de su catálogo REST desde ClickHouse Cloud.
        * Que dispone de credenciales de cliente OAuth o un token Bearer, según la configuración de su catálogo.
        * Que dispone de un URI de **Storage Endpoint** de S3 o compatible para los datos de las tablas (por ejemplo, `s3://my-bucket/path`).

        En el panel lateral:

        1. Introduzca la **URL del catálogo** (por ejemplo, `https://catalog.example.com/v1`).
        2. Introduzca el **Warehouse** o el espacio de nombres del catálogo (por ejemplo, `demo`).
        3. Introduzca el prefijo del URI de **Storage Endpoint** para el almacenamiento de las tablas.
        4. Seleccione un **método de autenticación**: **Credenciales de cliente OAuth** o **token Bearer**; a continuación, introduzca las credenciales correspondientes.
        5. Introduzca un **nombre de base de datos** para la base de datos de ClickHouse que expone las tablas de su catálogo REST.
      </Tab>

      <Tab title="Microsoft OneLake" id="onelake">
        Consulta tablas [Iceberg](/docs/es/reference/engines/table-engines/integrations/iceberg) en Microsoft Fabric OneLake mediante credenciales de una aplicación de Azure AD. Consulta la [guía de Fabric OneLake](/docs/es/guides/use-cases/data-warehousing/onelake-catalog) para conocer la configuración completa.

        Antes de conectarte, confirma lo siguiente:

        * ClickHouse versión 25.12 o posterior.
        * Existen tablas Iceberg en un espacio de trabajo de Fabric.
        * Tienes una aplicación de Entra ID (Azure AD) con ID de cliente y secreto.
        * Tienes el ID de tenant, el ID del espacio de trabajo y un ID de elemento de datos. Usa el **ID de Lakehouse** de la URL de la página de Lakehouse. Consulta los [requisitos previos de Microsoft OneLake](https://learn.microsoft.com/en-us/fabric/onelake/table-apis/table-apis-overview#prerequisites) para obtener ayuda sobre cómo localizar estos valores.

        En el panel desplegable:

        1. Introduce el **ID del espacio de trabajo** de Fabric.
        2. Introduce el **ID de elemento de datos** — usa el ID de Lakehouse. No se admiten ID de warehouse.
        3. Introduce el **ID de tenant**, el **ID de aplicación (cliente)** y el **secreto de cliente** de Entra ID.
        4. Introduce un **nombre de base de datos** para la base de datos de ClickHouse que expone las tablas de OneLake.
      </Tab>

      <Tab title="Polaris" id="polaris">
        Conéctese a una implementación de Snowflake Open Catalog (Polaris) para tablas [Iceberg](/docs/es/reference/engines/table-engines/integrations/iceberg). Consulte la [guía del catálogo Polaris](/docs/es/guides/use-cases/data-warehousing/polaris-catalog) para ver la configuración completa.

        Antes de conectarse, confirme lo siguiente:

        * Utiliza ClickHouse versión 26.2 o posterior.
        * Tiene un catálogo Polaris con credenciales de cliente OAuth.
        * Tiene un URI de endpoint de almacenamiento para los datos de las tablas Iceberg (por ejemplo, `s3://company-iceberg-prod/warehouse/`).

        En el panel lateral:

        1. Introduzca el **Identificador de cuenta del catálogo** (por ejemplo, `ab12345.snowflakecomputing.com`).
        2. Introduzca el **Nombre del catálogo** (por ejemplo, `snowflake_open_catalog`).
        3. Introduzca el **ID de cliente** y el **Secreto de cliente** de OAuth.
        4. Introduzca el prefijo de URI del **Endpoint de almacenamiento** para las tablas.
        5. Introduzca un **Nombre de base de datos** para la base de datos de ClickHouse que expone las tablas de Polaris.
      </Tab>

      <Tab title="BigLake Metastore" id="biglake">
        Conéctate a Google Cloud BigLake Metastore (también conocido como Lakehouse runtime catalog) para tablas [Iceberg](/docs/es/reference/engines/table-engines/integrations/iceberg) en GCS. Consulta la [guía de BigLake Metastore](/docs/es/guides/use-cases/data-warehousing/biglake-catalog) para obtener instrucciones completas de configuración.

        Antes de conectarte, confirma lo siguiente:

        * ClickHouse versión 26.2 o posterior.
        * Tienes una instancia de BigLake Metastore con tablas Iceberg en GCS.
        * Tienes credenciales predeterminadas de aplicación de Google (ADC) con ID de cliente, secreto de cliente, token de actualización e ID de proyecto de cuota.

        En el panel desplegable:

        1. Introduce tu **ID de cliente de Google ADC**, **secreto de cliente**, **token de actualización** e **ID de proyecto de cuota**.
        2. Introduce el URI del **bucket de Cloud Storage** para los datos de las tablas (por ejemplo, `gs://biglake-public-nyc-taxi-iceberg`).
        3. Introduce un **nombre de base de datos** para la base de datos de ClickHouse que expone tus tablas de BigLake.
      </Tab>
    </Tabs>
  </Step>

  <Step title="Guarda la conexión" id="save-connection">
    Después de completar los campos:

    1. Haz clic en **Add catalog**. ClickHouse valida la conexión y las credenciales al guardar.
    2. Si la operación se realiza correctamente, aparece una notificación de confirmación con un enlace **View in SQL console**. Tu catálogo se muestra en la tabla **Linked catalogs**, junto con su estado de conexión y el número de tablas.

    Desde el menú **Actions** de una fila de catálogo vinculado, puedes eliminar la conexión del catálogo. Al eliminarla, se quita de ClickHouse la base de datos del catálogo, pero no se eliminan datos de tu catálogo externo.
  </Step>
</Steps>

<div id="query-data">
  ## Consulta tus datos
</div>

<Steps>
  <Step title="Ver las tablas de tu catálogo" id="view-tables">
    En la página **Fuentes de datos**, busca tu catálogo en la tabla **Linked catalogs** y haz clic en **View tables**.

    <Image img="https://mintcdn.com/private-7c7dfe99/Z-ZVGWH-X46hMIiN/images/integrations/data-catalogs/linked-catalogs-table.png?fit=max&auto=format&n=Z-ZVGWH-X46hMIiN&q=85&s=0a1cc4e94f2ef096d9db5e5edf8699b6" alt="Tabla Linked catalogs con la acción View tables" size="lg" width="3510" height="868" data-path="images/integrations/data-catalogs/linked-catalogs-table.png" />

    ClickHouse abre la consola SQL con la base de datos de tu catálogo seleccionada y muestra las tablas disponibles.

    <Note>
      Es posible que las tablas no aparezcan inmediatamente después de conectar un catálogo. Según el catálogo, pueden tardar hasta 3 minutos en aparecer todas las tablas.
    </Note>

    <Image img="https://mintcdn.com/private-7c7dfe99/Z-ZVGWH-X46hMIiN/images/integrations/data-catalogs/catalog-tables-browser.png?fit=max&auto=format&n=Z-ZVGWH-X46hMIiN&q=85&s=659600c739c761d3154018e338596fa6" alt="Explorador de tablas de la consola SQL que muestra las tablas del catálogo" size="lg" width="3560" height="1578" data-path="images/integrations/data-catalogs/catalog-tables-browser.png" />
  </Step>

  <Step title="Ejecutar una consulta" id="run-a-query">
    Escribe una consulta en el editor SQL y haz clic en **Run**. Encierra el nombre completo de la tabla entre comillas invertidas:

    ```sql theme={null}
    SELECT * FROM `identity_profiles.identity_profiles_iceberg`
    ```

    <Image img="https://mintcdn.com/private-7c7dfe99/Z-ZVGWH-X46hMIiN/images/integrations/data-catalogs/catalog-sql-query.png?fit=max&auto=format&n=Z-ZVGWH-X46hMIiN&q=85&s=79bfd73f1b475795f1fd0e3c18950b50" alt="Consulta SQL con resultados que usa comillas invertidas para el nombre de tabla con puntos" size="lg" width="2810" height="1172" data-path="images/integrations/data-catalogs/catalog-sql-query.png" />
  </Step>
</Steps>

<div id="troubleshooting">
  ## Solución de problemas
</div>

* Si no ve sus tablas en la consola SQL, verifique las credenciales, el acceso a la red y los tipos de tabla en el catálogo. Asegúrese de que las tablas que espera ver utilicen formatos de archivo y de tabla compatibles.

<div id="see-also">
  ## Consulte también
</div>

* [Acelerar la analítica sobre datos de lakehouse](/docs/es/guides/use-cases/data-warehousing/getting-started/accelerating-analytics) — cargar tablas del catálogo en MergeTree para consultas repetidas
* [Acceder de forma segura a datos de Iceberg](/docs/es/products/cloud/guides/data-sources/accessing-iceberg-data-securely) — configuración de roles de IAM para acceder a AWS Iceberg y Glue