> ## 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 paso a paso sobre cómo configurar Amazon RDS MariaDB como fuente para ClickPipes

# Guía de configuración de RDS MariaDB como fuente

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

Esta es una guía paso a paso para configurar su instancia de RDS MariaDB a fin de replicar sus datos mediante ClickPipe para MySQL.

<br />

<Info>
  También recomendamos consultar las preguntas frecuentes de MySQL [aquí](/docs/es/integrations/clickpipes/mysql/faq). La página de preguntas frecuentes se actualiza activamente.
</Info>

<div id="enable-binlog-retention-rds">
  ## Habilitar la retención del binlog
</div>

El binlog es un conjunto de archivos de log que contienen información sobre las modificaciones de datos realizadas en una instancia del servidor MySQL. Los archivos de binlog son necesarios para la replicación. Deben seguirse ambos pasos que se indican a continuación:

<Steps>
  <Step title="Habilitar el binary logging mediante copias de seguridad automatizadas" id="enable-binlog-logging-rds">
    La función de copias de seguridad automatizadas determina si el binary logging está activado o desactivado para MySQL. Se puede configurar en la consola de AWS:

    <Image img="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/mysql/source/rds/rds-backups.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=21ca5d0f6d6dfda1a398b336782fb229" alt="Habilitación de copias de seguridad automatizadas en RDS" size="lg" border width="3230" height="530" data-path="images/integrations/data-ingestion/clickpipes/mysql/source/rds/rds-backups.webp" />

    Es recomendable establecer la retención de copias de seguridad en un valor razonablemente largo en función del caso de uso de la replicación.
  </Step>

  <Step title="Horas de retención del binlog" id="binlog-retention-hours-rds">
    Amazon RDS para MariaDB utiliza un método distinto para configurar la duración de retención del binlog, es decir, el tiempo durante el que se conserva un archivo de binlog que contiene cambios. Si algunos cambios no se leen antes de que se elimine el archivo de binlog, la replicación no podrá continuar. El valor predeterminado de las horas de retención del binlog es NULL, lo que significa que los logs binarios no se conservan.

    Para especificar la cantidad de horas durante las que se conservarán los logs binarios en una instancia de base de datos, use la función mysql.rds\_set\_configuration con un período de retención del binlog lo bastante largo como para que se produzca la replicación. `24 hours` es el mínimo recomendado.

    ```text theme={null}
    mysql=> call mysql.rds_set_configuration('binlog retention hours', 24);
    ```
  </Step>
</Steps>

<div id="binlog-parameter-group-rds">
  ## Configurar los ajustes de binlog en el grupo de parámetros
</div>

Puede encontrar el grupo de parámetros haciendo clic en su instancia de MariaDB en la RDS Console y, a continuación, navegando a la pestaña `Configurations`.

<Image img="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/mysql/parameter_group/rds_config.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=ee075e27abc1cdb0dca1962d200384a3" alt="Dónde encontrar el grupo de parámetros en RDS" size="lg" border width="708" height="853" data-path="images/integrations/data-ingestion/clickpipes/mysql/parameter_group/rds_config.webp" />

Al hacer clic en el enlace del grupo de parámetros, accederá a la página del grupo de parámetros. Verá un botón `Edit` en la esquina superior derecha:

<Image img="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/mysql/parameter_group/edit_button.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=3b73e47820d72b09c2238a8fce0df716" alt="Editar grupo de parámetros" size="lg" border width="1662" height="292" data-path="images/integrations/data-ingestion/clickpipes/mysql/parameter_group/edit_button.webp" />

Los ajustes `binlog_format`, `binlog_row_metadata` y `binlog_row_image` deben establecerse de la siguiente manera:

1. `binlog_format` en `ROW`.

<Image img="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/mysql/parameter_group/binlog_format.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=98ccb656415f8e43ebfe03c26f4bf908" alt="Formato de binlog en ROW" size="lg" border width="960" height="232" data-path="images/integrations/data-ingestion/clickpipes/mysql/parameter_group/binlog_format.webp" />

2. `binlog_row_metadata` en `FULL`

<Image img="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/mysql/parameter_group/binlog_row_metadata.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=75008a3321f0b26b2111d8f14d80e3fe" alt="Metadatos de fila de binlog en FULL" size="lg" border width="934" height="234" data-path="images/integrations/data-ingestion/clickpipes/mysql/parameter_group/binlog_row_metadata.webp" />

3. `binlog_row_image` en `FULL`

<Image img="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/mysql/parameter_group/binlog_row_image.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=a5660a6f88829e05eefca1eb7dcea83a" alt="Imagen de fila de binlog en FULL" size="lg" border width="934" height="234" data-path="images/integrations/data-ingestion/clickpipes/mysql/parameter_group/binlog_row_image.webp" />

A continuación, haga clic en `Save Changes` en la esquina superior derecha. Es posible que deba reiniciar su instancia para que los cambios surtan efecto. Si ve `Pending reboot` junto al enlace del grupo de parámetros en la pestaña `Configurations` de la instancia de RDS, es un buen indicio de que debe reiniciar la instancia.

<br />

<Tip>
  Si tiene un clúster de MariaDB, los parámetros anteriores se encontrarán en un grupo de parámetros de [DB Cluster](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.CreatingCluster.html) y no en el grupo de la instancia de DB.
</Tip>

<div id="gtid-mode-rds">
  ## Habilitación del modo GTID
</div>

Los identificadores globales de transacción (GTID) son identificadores únicos asignados a cada transacción confirmada en MySQL/MariaDB. Simplifican la replicación del binlog y facilitan la resolución de problemas. MariaDB habilita el modo GTID de forma predeterminada, por lo que no es necesario que el usuario realice ninguna acción para usarlo.

<div id="configure-database-user-rds">
  ## Configurar un usuario de base de datos
</div>

Conéctese a su instancia de RDS MariaDB como administrador y ejecute los siguientes comandos:

1. Cree un usuario específico para ClickPipes:

   ```sql theme={null}
   CREATE USER 'clickpipes_user'@'host' IDENTIFIED BY 'some-password';
   ```

2. Conceda permisos sobre el esquema. El siguiente ejemplo muestra permisos para la base de datos `mysql`. Repita estos comandos para cada base de datos y host que desee replicar:

   ```sql theme={null}
   GRANT SELECT ON `mysql`.* TO 'clickpipes_user'@'host';
   ```

3. Conceda permisos de replicación al usuario:

   ```sql theme={null}
   GRANT REPLICATION CLIENT ON *.* TO 'clickpipes_user'@'%';
   GRANT REPLICATION SLAVE ON *.* TO 'clickpipes_user'@'%';
   ```

<div id="configure-network-access">
  ## Configurar el acceso de red
</div>

<div id="ip-based-access-control">
  ### Control de acceso basado en IP
</div>

Si desea restringir el tráfico hacia su instancia de RDS, añada las [IP estáticas de NAT documentadas](/docs/es/integrations/clickpipes/home#list-of-static-ips) a las `reglas de entrada` de su grupo de seguridad de RDS.

<Image img="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/mysql/source/rds/security-group-in-rds-mysql.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=af38397cd478a3e845217f3cc0165a7f" alt="¿Dónde encontrar el grupo de seguridad en RDS?" size="lg" border width="2850" height="994" data-path="images/integrations/data-ingestion/clickpipes/mysql/source/rds/security-group-in-rds-mysql.webp" />

<Image img="https://mintcdn.com/private-7c7dfe99/dZZG_-B0EzCG8L4V/images/integrations/data-ingestion/clickpipes/postgres/source/rds/edit_inbound_rules.webp?fit=max&auto=format&n=dZZG_-B0EzCG8L4V&q=85&s=1176aa14815b965b841d70d28b5f0d7c" alt="Editar las reglas de entrada del grupo de seguridad anterior" size="lg" border width="1800" height="935" data-path="images/integrations/data-ingestion/clickpipes/postgres/source/rds/edit_inbound_rules.webp" />

<div id="private-access-via-aws-privatelink">
  ### Acceso privado mediante AWS PrivateLink
</div>

Para conectarse a su instancia de RDS a través de una red privada, puede utilizar AWS PrivateLink. Siga nuestra [guía de configuración de AWS PrivateLink para ClickPipes](/docs/es/resources/support-center/knowledge-base/cloud-services/aws-privatelink-setup-for-clickpipes) para establecer la conexión.
