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

> Configura una integración entre Estuary y ClickHouse mediante ClickPipes

# Ingiere datos de Estuary mediante ClickPipes

export const PartnerBadge = () => {
  return <div className="PartnerBadge">
            <div className="PartnerBadgeIcon">
                <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                    <polyline points="12.5 9.5 10 12 6 11 2.5 8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="4.54 4.41 8 3.5 11.46 4.41" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M2.15,3.78 L0.55,6.95 A0.5,0.5 0,0,0 0.77,7.62 L2.5,8.5 L4.54,4.41 L2.82,3.55 A0.5,0.5 0,0,0 2.15,3.78 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M13.5,8.5 L15.23,7.62 A0.5,0.5 0,0,0 15.45,6.95 L13.85,3.78 A0.5,0.5 0,0,0 13.18,3.55 L11.46,4.41 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M11.5,4.5 L9,4.5 L6.15,7.27 A0.5,0.5 0,0,0 6.24,8.05 C7.33,8.74 8.81,8.72 10,7.5 L12.5,9.5 L13.5,8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="7.75 13.5 5.15 12.85 3.5 11.67" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                </svg>
            </div>
            Integración de partner
        </div>;
};

<PartnerBadge />

Estuary puede conectarse a ClickHouse mediante Kafka ClickPipe.

Con esta integración, no necesita mantener su propio ecosistema de Kafka. En su lugar, Estuary emite datos nuevos como mensajes de Kafka. Puede configurar un Kafka ClickPipe para usar la información del broker y del registro de esquemas de Estuary para consumir estos mensajes.

Consulte la [integración directa de Estuary con ClickHouse](/docs/es/integrations/connectors/data-ingestion/community-integrations/estuary-native) como alternativa.

<div id="setup-guide">
  ## Guía de configuración
</div>

**Requisitos previos**

Necesitará:

* Una [cuenta de Estuary](https://dashboard.estuary.dev/register)
* Una o varias [**capturas**](https://docs.estuary.dev/concepts/captures/) en Estuary que extraigan datos de las fuentes que desee
* Una cuenta de ClickHouse Cloud con permisos para ClickPipe

<Steps>
  <Step title="Crear una materialización de Estuary" id="1-create-an-estuary-materialization">
    Para transferir datos de las colecciones de origen de Estuary a ClickHouse, primero debe crear una **materialización**.

    1. En el panel de control de Estuary, vaya a la página [Destinations](https://dashboard.estuary.dev/materializations).
    2. Haga clic en **+ New Materialization**.
    3. Seleccione el conector **ClickHouse Kafka API**.
    4. Complete la información de las secciones Materialization, Endpoint y Source Collections:
       * **Detalles de la materialización:** Asigne un nombre único a la materialización y elija un plano de datos (proveedor de nube y región).
       * **Configuración del endpoint:** Proporcione un **token de autenticación** seguro.
       * **Colecciones de origen:** Vincule una **captura** existente o seleccione las colecciones de datos que desea exponer a ClickHouse.
    5. Haga clic en **Next** y en **Save and Publish**.
    6. En la página de detalles de la materialización, anote el nombre completo de su materialización de ClickHouse. Tendrá un aspecto similar a `your-tenant/your-unique-name/dekaf-clickhouse`.

    Estuary comenzará a transmitir las colecciones seleccionadas como mensajes de Kafka. ClickHouse puede acceder a estos datos mediante un Kafka ClickPipe con la información del broker de Estuary y el token de autenticación proporcionado.
  </Step>

  <Step title="Introducir los detalles de conexión de Kafka" id="2-enter-kafka-connection-details">
    Configure un nuevo Kafka ClickPipe en ClickHouse e introduzca los detalles de conexión:

    1. En el panel de control de ClickHouse Cloud, seleccione **Fuentes de datos**.
    2. Cree un nuevo **ClickPipe**.
    3. Elija **Apache Kafka** como fuente de datos.
    4. Introduzca los detalles de conexión de Kafka con la información del broker y del registro de esquemas de Estuary:
       * Asigne un nombre a su ClickPipe.
       * Para el broker, use: `dekaf.estuary-data.com:9092`.
       * Deje la autenticación con la opción predeterminada `SASL/PLAIN`.
       * Para el usuario, introduzca el nombre completo de su materialización de Estuary (por ejemplo, `your-tenant/your-unique-name/dekaf-clickhouse`).
       * Para la contraseña, introduzca el token de autenticación proporcionado para la materialización.
    5. Active la opción de registro de esquemas:
       * Para la URL del esquema, use: `https://dekaf.estuary-data.com`.
       * La clave del esquema será la misma que el usuario del broker (el nombre de la materialización).
       * El secreto será el mismo que la contraseña del broker (el token de autenticación).
  </Step>

  <Step title="Configurar los datos entrantes" id="3-configure-incoming-data">
    1. Seleccione uno de sus **topics** de Kafka (una de las colecciones de datos de Estuary).
    2. Elija un **offset**.
    3. ClickHouse detectará los mensajes del topic. Puede continuar a la sección **Parse information** para configurar la información de la tabla.
    4. Elija crear una tabla nueva o cargar los datos en una tabla existente que coincida.
    5. Asigne los campos de origen a las columnas de la tabla y confirme el nombre de la columna, el tipo y si admite valores nulos.
    6. En la sección final **Details and settings**, puede seleccionar permisos para su usuario de base de datos dedicado.

    Cuando esté conforme con la configuración, cree el ClickPipe.

    ClickHouse aprovisionará la nueva fuente de datos y comenzará a consumir mensajes de Estuary. Cree tantos ClickPipes como necesite para transmitir datos de todas las colecciones que desee.
  </Step>
</Steps>

<div id="additional-resources">
  ## Recursos adicionales
</div>

Para obtener más información sobre cómo configurar una integración de ClickPipe con Estuary, consulte la documentación de Estuary:

* Consulte la [documentación de materialización de ClickHouse](https://docs.estuary.dev/reference/Connectors/materialization-connectors/Dekaf/clickhouse/) de Estuary para la integración con ClickPipes.
* Estuary expone los datos como mensajes de Kafka mediante **Dekaf**. Puede obtener más información sobre Dekaf en la [guía de Estuary](https://docs.estuary.dev/guides/dekaf_reading_collections_from_kafka/).