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

> Envía diversas fuentes a ClickHouse mediante una integración con Estuary

# Conecta Estuary con ClickHouse

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](https://estuary.dev/) es una plataforma de datos right-time que combina de forma flexible datos en tiempo real y por lotes en pipelines de ETL fáciles de configurar. Con seguridad de nivel empresarial y opciones de implementación, Estuary habilita flujos de datos duraderos desde fuentes de SaaS, bases de datos y streaming hacia una variedad de destinos, incluido ClickHouse.

Estuary se conecta con ClickHouse a través del ClickPipe de Kafka. No necesitas mantener tu propio ecosistema de Kafka con esta integración.

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

**Requisitos previos**

* Una [cuenta de Estuary](https://dashboard.estuary.dev/register)
* Una o más [**capturas**](https://docs.estuary.dev/concepts/captures/) en Estuary que extraigan datos de las fuentes que quieras
* 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 mover datos de tus colecciones de origen en Estuary a ClickHouse, primero tendrás que crear una **materialización**.

    1. En el dashboard de Estuary, ve a la página [Destinations](https://dashboard.estuary.dev/materializations).

    2. Haz clic en **+ New Materialization**.

    3. Selecciona el conector **ClickHouse**.

    4. Completa la información en las secciones Materialization, Endpoint y Source Collections:

       * **Materialization Details:** Proporciona un nombre único para tu materialización y elige un plano de datos (proveedor cloud y región)

       * **Endpoint Config:** Proporciona un **Auth Token** seguro

       * **Source Collections:** Vincula una **captura** existente o selecciona colecciones de datos para exponerlas en ClickHouse

    5. Haz clic en **Next** y **Save and Publish**.

    6. En la página de detalles de la materialización, toma nota del nombre completo de tu materialización de ClickHouse. Tendrá un aspecto similar a `your-tenant/your-unique-name/dekaf-clickhouse`.

    Estuary empezará a transmitir las colecciones seleccionadas como mensajes de Kafka. ClickHouse puede acceder a estos datos mediante un Kafka ClickPipe con los detalles del broker de Estuary y el token de autenticación que proporcionaste.
  </Step>

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

    1. En tu dashboard de ClickHouse Cloud, selecciona **Data sources**.

    2. Crea un nuevo **ClickPipe**.

    3. Elige **Apache Kafka** como fuente de datos.

    4. Introduce los detalles de conexión de Kafka con la información del broker y del schema registry de Estuary:

       * Proporciona un nombre para tu ClickPipe
       * Para el broker, usa: `dekaf.estuary-data.com:9092`
       * Deja la autenticación con la opción predeterminada `SASL/PLAIN`
       * Para el usuario, introduce el nombre completo de tu materialización de Estuary (por ejemplo, `your-tenant/your-unique-name/dekaf-clickhouse`)
       * Para la contraseña, introduce el token de autenticación que proporcionaste para tu materialización

    5. Activa la opción de schema registry

       * Para la URL del schema, usa: `https://dekaf.estuary-data.com`
       * La clave del schema será la misma que la del usuario del broker (el nombre de tu materialización)
       * El secreto será el mismo que la contraseña del broker (tu token de autenticación)
  </Step>

  <Step title="Configurar los datos entrantes" id="3-configure-incoming-data">
    1. Selecciona uno de tus Kafka **topics** (una de tus colecciones de datos de Estuary).

    2. Elige un **offset**.

    3. ClickHouse detectará los mensajes del topic. Puedes continuar a la sección **Parse information** para configurar la información de tu tabla.

    4. Elige si quieres crear una tabla nueva o cargar datos en una tabla existente que coincida.

    5. Asigna los campos de origen a las columnas de la tabla y confirma el nombre de la columna, el tipo y si admite Nullable.

    6. En la sección final **Details and settings**, puedes seleccionar permisos para tu usuario de base de datos dedicado.

    Cuando estés conforme con la configuración, crea tu ClickPipe.

    ClickHouse aprovisionará tu nueva fuente de datos y empezará a consumir mensajes de Estuary. Crea tantos ClickPipes como necesites para transmitir datos desde todas las colecciones que quieras.
  </Step>
</Steps>

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

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

* Consulta la [documentación de materialización de ClickHouse](https://docs.estuary.dev/reference/Connectors/materialization-connectors/Dekaf/clickhouse/) de Estuary.

* Estuary expone los datos como mensajes de Kafka mediante **Dekaf**. Puedes obtener más información sobre Dekaf [aquí](https://docs.estuary.dev/guides/dekaf_reading_collections_from_kafka/).

* Para ver una lista de las fuentes cuyos datos puedes transmitir a ClickHouse con Estuary, consulta los [conectores de captura de Estuary](https://docs.estuary.dev/reference/Connectors/capture-connectors/).