Configurar um banco de dados MySQL autogerenciado para CDC

Com o Datastream, é possível transmitir atualizações de captura de dados alterados (CDC) de um banco de dados MySQL autogerenciado para um destino compatível, como o BigQuery ou o Cloud Storage. Para preparar a origem, configure a geração de registros binários completa com base em linhas com um período de armazenamento de sete dias e crie um usuário do Datastream com privilégios de replicação. Também é possível usar essa configuração para bancos de dados compatíveis, como MariaDB, Percona Server para MySQL e Alibaba Cloud PolarDB.

Verifique a configuração e o período de armazenamento do registro binário

1. Confirme se o registro binário está configurado corretamente digitando o seguinte comando do MySQL:

   SHOW GLOBAL VARIABLES LIKE '%binlog_format%';
   

2. Verifique se o valor da variável binlog_format está definido como ROW. O Datastream não é compatível com os formatos de registro binário MIXED ou STATEMENT.

3. Confirme se o formato de linha do registro binário está definido como FULL digitando o seguinte comando do MySQL:

   SHOW GLOBAL VARIABLES LIKE 'binlog_row_image';
   

4. Para as versões 8.0 e mais recentes do MySQL, confirme se a variável binlog_row_value_options está definida como um valor vazio digitando o seguinte comando do MySQL:

   SHOW GLOBAL VARIABLES LIKE 'binlog_row_value_options';
   

5. Verifique se a opção de atualizações de réplica do registro binário está definida como ON. Para isso, digite o seguinte comando do MySQL:

   SHOW GLOBAL VARIABLES LIKE 'log_replica_updates';
   

   Para versões do MySQL anteriores à 8.0.26, digite o seguinte comando:

   SHOW GLOBAL VARIABLES LIKE 'log_slave_updates';
   

6. Verifique se o período de armazenamento do registro binário está definido como 604800 segundos (7 dias) digitando o seguinte comando do MySQL:

   SHOW GLOBAL VARIABLES LIKE 'binlog_expire_logs_seconds';
   

   Para versões do MySQL anteriores à 8.0.3, digite o seguinte comando:

   SHOW GLOBAL VARIABLES LIKE 'expire_logs_days';
   

   Se o banco de dados do MySQL não estiver definido para replicação completa com base em linhas e um período de armazenamento de sete dias, será necessário alterar a configuração do registro binário da seguinte maneira:

   1. Navegue até o diretório /etc/mysql/.
   2. Usando um editor, abra o arquivo my.cnf.
   3. Adicione as seguintes linhas ao arquivo:

        [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 a replicação com base em GTID, adicione também as linhas a seguir:

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

   5. Salve as mudanças no arquivo my.cnf e feche-o.
   6. Reinicie o servidor MySQL para que as alterações feitas entrem em vigor.

Criar um usuário do Datastream

1. Para criar um usuário do Datastream, insira os seguintes comandos do MySQL:

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

A seguir

• Saiba mais sobre como o Datastream funciona com origens do MySQL.