Configura una base de datos de MySQL autoadministrada para la CDC

En esta página, se describe cómo configurar la captura de datos modificados (CDC) para transmitir datos desde una base de datos de MySQL autoadministrada a un destino compatible, como BigQuery o Cloud Storage. Estas instrucciones también funcionan para bases de datos como MariaDB, Percona Server para MySQL o Alibaba Cloud PolarDB.

Verifica la configuración y el período de retención del registro binario

1. Ingresa el siguiente comando de MySQL para confirmar que el registro binario se configuró correctamente:

   SHOW GLOBAL VARIABLES LIKE '%binlog_format%';
   

2. Verifica que el valor de la variable binlog_format esté establecido en ROW. Datastream no admite los formatos de registro binario MIXED ni STATEMENT.

3. Ingresa el siguiente comando de MySQL para confirmar que el formato de fila del registro binario esté configurado como FULL:

   SHOW GLOBAL VARIABLES LIKE 'binlog_row_image';
   

4. Ingresa el siguiente comando de MySQL para verificar que la opción de actualizaciones de la réplica del registro binario esté configurada como ON:

   SHOW GLOBAL VARIABLES LIKE 'log_replica_updates';
   

   Para las versiones de MySQL anteriores a la 8.0.26, ingresa el siguiente comando:

   SHOW GLOBAL VARIABLES LIKE 'log_slave_updates';
   

5. Ingresa el siguiente comando de MySQL para verificar que el período de retención del registro binario esté configurado en 604800 segundos (7 días):

   SHOW GLOBAL VARIABLES LIKE 'binlog_expire_logs_seconds';
   

   Para las versiones de MySQL anteriores a la 8.0.3, ingresa el siguiente comando:

   SHOW GLOBAL VARIABLES LIKE 'expire_logs_days';
   

   Si tu base de datos MySQL no está configurada en la replicación basada en filas completas ni en un período de retención de 7 días, deberás cambiar la configuración del registro binario de la siguiente manera:

   1. Navega al directorio /etc/mysql/.
   2. Abre el archivo my.cnf con un editor.
   3. Agrega las siguientes líneas al archivo:

        [mysqld]
        log-bin=mysql-bin
        server-id=1
        binlog_format=ROW
        log-replica-updates=1
        # For MySQL versions earlier than 8.0.26, use log-slave-updates=true
        # instead.
        binlog_expire_logs_seconds=604800
        # For MySQL versions earlier than 8.0.3, use expire_logs_days=7 instead.
        max_allowed_packet=1G
        # '1G' is the recommended value.
        

   4. Para la replicación basada en GTID, también agrega las siguientes líneas:

        [mysqld]
        gtid_mode=ON
        enforce-gtid-consistency=ON
        

   5. Guarda los cambios en el archivo my.cnf y, luego, ciérralo.
   6. Reinicia el servidor MySQL para que se apliquen los cambios.

Crea un usuario de Datastream

1. Para crear un usuario de DataStream, ingresa los siguientes comandos de MySQL:

   CREATE USER 'datastream'@'%' IDENTIFIED BY 'YOUR_PASSWORD';
   GRANT REPLICATION SLAVE, SELECT, REPLICATION CLIENT ON *.* TO 'datastream'@'%';
   FLUSH PRIVILEGES;

¿Qué sigue?

• Obtén más información sobre cómo funciona Datastream con las fuentes de MySQL.