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

> Guía para usar ClickHouse Connector Sink totalmente gestionado en Confluent Cloud

# Integración de Confluent Cloud con ClickHouse

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>;
};

<div class="vimeo-container">
  <Frame>
    <iframe
      src="//www.youtube.com/embed/SQAiPVbd3gg"
      frameborder="0"
      allow="autoplay;
fullscreen;
picture-in-picture"
      allowfullscreen
    />
  </Frame>
</div>

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

Suponemos que estás familiarizado con:

* [ClickHouse Connector Sink](/docs/es/integrations/connectors/data-ingestion/kafka/kafka-clickhouse-connect-sink)
* Confluent Cloud

<div id="the-official-kafka-connector-from-clickhouse-with-confluent-cloud">
  ## El conector oficial de ClickHouse para Kafka con Confluent Cloud
</div>

<div id="create-a-topic">
  #### Crear un topic
</div>

Crear un topic en Confluent Cloud es bastante sencillo y encontrarás instrucciones detalladas [aquí](https://docs.confluent.io/cloud/current/client-apps/topics/manage.html).

<div id="important-notes">
  #### Notas importantes
</div>

* El nombre del topic de Kafka debe ser el mismo que el de la tabla de ClickHouse. Esto se puede ajustar mediante un transformador (por ejemplo, [`ExtractTopic`](https://docs.confluent.io/platform/current/connect/transforms/extracttopic.html)).
* Tener más particiones no siempre implica un mayor rendimiento; consulta nuestra próxima guía para obtener más detalles y consejos de rendimiento.

<div id="gather-your-connection-details">
  #### Recopila los datos de conexión
</div>

Para conectarse a ClickHouse con HTTP(S), necesita esta información:

| Parámetro(s)              | Descripción                                                                                                                       |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `HOST` and `PORT`         | Normalmente, el puerto es 8443 cuando se usa TLS o 8123 cuando no se usa TLS.                                                     |
| `DATABASE NAME`           | De forma predeterminada, existe una base de datos llamada `default`; use el nombre de la base de datos a la que desea conectarse. |
| `USERNAME` and `PASSWORD` | De forma predeterminada, el nombre de usuario es `default`. Use el nombre de usuario adecuado para su caso de uso.                |

Los detalles de su servicio de ClickHouse Cloud están disponibles en la consola de ClickHouse Cloud.
Seleccione un servicio y haga clic en **Connect**:

<div className="ch-image-md">
  <Frame>
    <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=ec0a298a33ca841e947fa5e8bae47362" alt="Botón Connect del servicio de ClickHouse Cloud" width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />
  </Frame>
</div>

Elija **HTTPS**. Los detalles de conexión se muestran en un comando `curl` de ejemplo.

<div className="ch-image-md">
  <Frame>
    <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=cb0fbd98aa2b5b7ca484c9f53395ee07" alt="Detalles de conexión HTTPS de ClickHouse Cloud" width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />
  </Frame>
</div>

Si usa ClickHouse autogestionado, los detalles de conexión los establece su administrador de ClickHouse.

<div id="install-connector">
  #### Instalar el conector
</div>

Instala el ClickHouse Sink Connector completamente gestionado en Confluent Cloud siguiendo la [documentación oficial](https://docs.confluent.io/cloud/current/connectors/cc-clickhouse-sink-connector/cc-clickhouse-sink.html).

<div id="configure-the-connector">
  #### Configurar el conector
</div>

Durante la configuración del ClickHouse Sink Connector, deberás proporcionar los siguientes datos:

* hostname de tu servidor de ClickHouse
* puerto de tu servidor de ClickHouse (el valor predeterminado es 8443)
* nombre de usuario y contraseña de tu servidor de ClickHouse
* nombre de la base de datos en ClickHouse donde se escribirán los datos
* nombre del topic de Kafka que se usará para escribir datos en ClickHouse

La UI de Confluent Cloud admite opciones avanzadas de configuración para ajustar los intervalos de sondeo, los tamaños de lote y otros parámetros a fin de optimizar el rendimiento.

<Note>
  En Confluent Cloud, para ajustar determinadas opciones, como la [configuración de fetch](/docs/es/integrations/connectors/data-ingestion/kafka/kafka-clickhouse-connect-sink#fetch-settings) y la [configuración de sondeo](/docs/es/integrations/connectors/data-ingestion/kafka/kafka-clickhouse-connect-sink#poll-settings), es necesario abrir un caso de soporte en Confluent Cloud.
</Note>

<div id="known-limitations">
  #### Limitaciones conocidas
</div>

* Consulta la lista de [limitaciones de los conectores en la documentación oficial](https://docs.confluent.io/cloud/current/connectors/cc-clickhouse-sink-connector/cc-clickhouse-sink.html#limitations)