Configura una base de datos de MySQL autoadministrada para la CDC

Datastream te permite transmitir actualizaciones de captura de datos modificados (CDC) desde una base de datos de MySQL autoadministrada a un destino compatible, como BigQuery o Cloud Storage. Para preparar tu fuente, configura el registro binario completo basado en filas con un período de retención de 7 días y crea un usuario de Datastream con privilegios de replicación. También puedes usar esta configuración para bases de datos compatibles, como MariaDB, Percona Server para MySQL y 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. Para las versiones 8.0 y posteriores de MySQL, ingresa el siguiente comando de MySQL para confirmar que la variable binlog_row_value_options esté configurada en un valor vacío:

   SHOW GLOBAL VARIABLES LIKE 'binlog_row_value_options';
   

5. Ingresa el siguiente comando de MySQL para verificar que la opción de actualizaciones de 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';
   

6. 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
        binlog_row_value_options=''
        # For MySQL versions 8.0 and later.
        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.