> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Ingiere fácilmente datos desde tu base de datos MySQL o MariaDB hacia ClickHouse Cloud.

# Ingesta de datos desde MySQL a ClickHouse (con CDC)

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

export const galaxyOnClick = eventName => () => {
  try {
    if (typeof window !== "undefined" && window.galaxy && eventName) {
      window.galaxy.track(eventName, {
        interaction: "click"
      });
    }
  } catch (e) {}
};

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}>
                <Icon />
                <span>Beta</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                Beta feature. 
                <u>
                    <a href="/docs/beta-and-experimental-features#beta-features">
                        Learn more.
                    </a>
                </u>
            </span>
        </div>;
};

<Info>
  La ingesta de datos de MySQL a ClickHouse Cloud mediante ClickPipes está en beta pública.
</Info>

El ClickPipe para MySQL proporciona una forma totalmente gestionada y resiliente de ingestar datos desde bases de datos MySQL y MariaDB a ClickHouse Cloud. Admite tanto **cargas masivas** para una sola ingestión como **captura de cambios en los datos (CDC)** para la ingestión continua.

Los ClickPipes para MySQL pueden desplegarse y gestionarse manualmente mediante la UI de ClickPipes, así como de forma programática mediante [OpenAPI](/es/integrations/clickpipes/programmatic-access/openapi) y [Terraform](/es/integrations/clickpipes/programmatic-access/terraform).

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

[//]: # "TODO La configuración de la replicación de binlog no es necesaria para los pipes de ingestión única. Esto ha generado confusión en el pasado, por lo que también deberíamos proporcionar los requisitos mínimos para las cargas masivas y así evitar ahuyentar a los usuarios."

Para empezar, primero debe asegurarse de que su base de datos MySQL esté correctamente configurada para la replicación de binlog. Los pasos de configuración dependen de cómo esté desplegando MySQL, así que siga la guía correspondiente a continuación:

<div id="supported-data-sources">
  ### Fuentes de datos compatibles
</div>

| Name                                                     | Logo | Details                                                                                                                                   |
| -------------------------------------------------------- | ---- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Amazon RDS MySQL** <br /> *Carga única, CDC*           |      | Siga la guía de configuración de [Amazon RDS MySQL](/es/integrations/clickpipes/mysql/source/rds).                                        |
| **Amazon Aurora MySQL** <br /> *Carga única, CDC*        |      | Siga la guía de configuración de [Amazon Aurora MySQL](/es/integrations/clickpipes/mysql/source/aurora).                                  |
| **Cloud SQL for MySQL** <br /> *Carga única, CDC*        |      | Siga la guía de configuración de [Cloud SQL for MySQL](/es/integrations/clickpipes/mysql/source/gcp).                                     |
| **Azure Flexible Server for MySQL** <br /> *Carga única* |      | Siga la guía de configuración de [Azure Flexible Server for MySQL](/es/integrations/clickpipes/mysql/source/azure-flexible-server-mysql). |
| **MySQL autoalojado** <br /> *Carga única, CDC*          |      | Siga la guía de configuración de [Generic MySQL](/es/integrations/clickpipes/mysql/source/generic).                                       |
| **Amazon RDS MariaDB** <br /> *Carga única, CDC*         |      | Siga la guía de configuración de [Amazon RDS MariaDB](/es/integrations/clickpipes/mysql/source/rds-maria).                                |
| **MariaDB autoalojado** <br /> *Carga única, CDC*        |      | Siga la guía de configuración de [Generic MariaDB](/es/integrations/clickpipes/mysql/source/generic-maria).                               |

Una vez configurada su base de datos MySQL de origen, puede continuar con la creación de su ClickPipe.

<div id="create-your-clickpipe">
  ## Crea tu ClickPipe
</div>

Asegúrate de haber iniciado sesión en tu cuenta de ClickHouse Cloud. Si aún no tienes una cuenta, puedes registrarte [aquí](https://cloud.clickhouse.com/).

[//]: # "   TODO update image here"

1. En la consola de ClickHouse Cloud, ve a tu servicio de ClickHouse Cloud.

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/cp_service.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=1fa8d992c5f2b6c481249d120e8715a2" alt="Servicio de ClickPipes" size="lg" border width="1184" height="482" data-path="images/integrations/data-ingestion/clickpipes/cp_service.png" />

2. Selecciona el botón `Data Sources` en el menú lateral izquierdo y haz clic en "Set up a ClickPipe"

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/cp_step0.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=8604d9b9df8655f1edcdc73536e5def1" alt="Seleccionar importaciones" size="lg" border width="2606" height="790" data-path="images/integrations/data-ingestion/clickpipes/cp_step0.png" />

3. Selecciona la tarjeta `MySQL CDC`

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/mysql/mysql-tile.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=440aa5315af39662e9dc50c6bc19a0d2" alt="Seleccionar MySQL" size="lg" border width="2612" height="892" data-path="images/integrations/data-ingestion/clickpipes/mysql/mysql-tile.png" />

<div id="add-your-source-mysql-database-connection">
  ### Añade la conexión de tu base de datos MySQL de origen
</div>

4. Completa los datos de conexión de tu base de datos MySQL de origen que configuraste en el paso de prerrequisitos.

<Info>
  Antes de empezar a añadir los datos de conexión, asegúrate de haber incluido las direcciones IP de ClickPipes en la lista de permitidos de tu firewall. En la página siguiente puedes encontrar una [lista de direcciones IP de ClickPipes](/es/integrations/clickpipes/home#list-of-static-ips).
  Para obtener más información, consulta las guías de configuración de MySQL de origen enlazadas en [la parte superior de esta página](#prerequisites).
</Info>

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/mysql/mysql-connection-details.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=26fbf77f95a6bc2a8f918f58c67e9530" alt="Completa los datos de conexión" size="lg" border width="1842" height="1556" data-path="images/integrations/data-ingestion/clickpipes/mysql/mysql-connection-details.png" />

<div id="optional-set-up-ssh-tunneling">
  #### (Opcional) Configurar el túnel SSH
</div>

Puede especificar los detalles del túnel SSH si su base de datos MySQL de origen no es accesible públicamente.

1. Active el interruptor "Usar túnel SSH".

2. Complete los datos de la conexión SSH.

   <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/8xU-7NRzcVe16bmG/images/integrations/data-ingestion/clickpipes/postgres/ssh-tunnel.jpg?fit=max&auto=format&n=8xU-7NRzcVe16bmG&q=85&s=c257ddbc479fb91047b029a3ddef29aa" alt="Túnel SSH" size="lg" border width="1780" height="1342" data-path="images/integrations/data-ingestion/clickpipes/postgres/ssh-tunnel.jpg" />

3. Para usar autenticación basada en claves, haga clic en "Revocar y generar par de claves" para generar un nuevo par de claves y copie la clave pública generada en su servidor SSH, en `~/.ssh/authorized_keys`.

4. Haga clic en "Verificar conexión" para comprobar la conexión.

<Note>
  Asegúrese de permitir las [direcciones IP de ClickPipes](/es/integrations/clickpipes/home#list-of-static-ips) en las reglas de su firewall para el host bastión SSH, de modo que ClickPipes pueda establecer el túnel SSH.
</Note>

Una vez completados los datos de la conexión, haga clic en `Next`.

<div id="advanced-settings">
  #### Configurar opciones avanzadas
</div>

Puede configurar las opciones avanzadas si es necesario. A continuación, se incluye una breve descripción de cada opción:

* **Intervalo de sincronización**: Es el intervalo con el que ClickPipes consultará la base de datos de origen en busca de cambios. Esto afecta al servicio de ClickHouse de destino; para los usuarios más sensibles a los costos, recomendamos mantenerlo en un valor alto (por encima de `3600`).
* **Hilos en paralelo para la carga inicial**: Es la cantidad de workers en paralelo que se usarán para obtener la instantánea inicial. Esto resulta útil cuando tiene una gran cantidad de tablas y quiere controlar el número de workers en paralelo utilizados para obtener la instantánea inicial. Esta opción se aplica por tabla.
* **Tamaño del lote de extracción**: El número de filas que se obtendrán en un solo lote. Esta es una opción de mejor esfuerzo y puede que no se respete en todos los casos.
* **Número de filas por partición en la instantánea**: Es el número de filas que se obtendrán en cada partición durante la instantánea inicial. Esto resulta útil cuando tiene una gran cantidad de filas en sus tablas y quiere controlar el número de filas obtenidas en cada partición.
* **Número de tablas en paralelo en la instantánea**: Es el número de tablas que se obtendrán en paralelo durante la instantánea inicial. Esto resulta útil cuando tiene una gran cantidad de tablas y quiere controlar el número de tablas obtenidas en paralelo.

<div id="configure-the-tables">
  ### Configura las tablas
</div>

5. Aquí puedes seleccionar la base de datos de destino para tu ClickPipe. Puedes elegir una base de datos existente o crear una nueva.

   <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/8xU-7NRzcVe16bmG/images/integrations/data-ingestion/clickpipes/mysql/select-destination-db.png?fit=max&auto=format&n=8xU-7NRzcVe16bmG&q=85&s=25847aef93aa36d6d3f94cdc2649579a" alt="Selecciona la base de datos de destino" size="lg" border width="2368" height="614" data-path="images/integrations/data-ingestion/clickpipes/mysql/select-destination-db.png" />

6. Puedes seleccionar las tablas que quieres replicar desde la base de datos MySQL de origen. Mientras las seleccionas, también puedes cambiarles el nombre en la base de datos de destino de ClickHouse, así como excluir columnas específicas.

<div id="review-permissions-and-start-the-clickpipe">
  ### Revisa los permisos e inicia ClickPipe
</div>

7. Selecciona el rol "Full access" en el menú desplegable de permisos y haz clic en "Complete Setup".

   <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/8xU-7NRzcVe16bmG/images/integrations/data-ingestion/clickpipes/postgres/ch-permissions.jpg?fit=max&auto=format&n=8xU-7NRzcVe16bmG&q=85&s=220285c9d16d656b26c97fd0587b9086" alt="Revisar permisos" size="lg" border width="1844" height="716" data-path="images/integrations/data-ingestion/clickpipes/postgres/ch-permissions.jpg" />

Por último, consulta la página ["FAQ de ClickPipes para MySQL"](/es/integrations/clickpipes/mysql/faq) para obtener más información sobre los problemas habituales y cómo resolverlos.

<div id="whats-next">
  ## ¿Qué sigue?
</div>

[//]: # "TODO Escribir una guía de migración específica para MySQL y buenas prácticas similares a la ya existente para PostgreSQL. La guía de migración actual apunta al motor de tabla de MySQL, lo cual no es ideal."

Una vez que hayas configurado tu ClickPipe para replicar datos de MySQL a ClickHouse Cloud, puedes centrarte en cómo consultar y modelar tus datos para obtener un rendimiento óptimo. Para consultas frecuentes sobre MySQL CDC y la resolución de problemas, consulta la [página de preguntas frecuentes de MySQL](/es/integrations/clickpipes/mysql/faq).
