Configurar um banco de dados MySQL autogerenciado para CDC

Nesta página, descrevemos como configurar a captura de dados alterados (CDC) para transmitir dados de um banco de dados MySQL autogerenciado para um destino compatível, como o BigQuery ou o Cloud Storage. Essas instruções também funcionam para bancos de dados como MariaDB, Percona Server para MySQL ou 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 formatos de log binário MIXED ou STATEMENT.

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

   SHOW GLOBAL VARIABLES LIKE 'binlog_row_image';
   

4. Para o MySQL 8.0 e versões mais recentes, confirme se a variável binlog_row_value_options está definida como um valor vazio inserindo 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 inserindo o seguinte comando do MySQL:

   SHOW GLOBAL VARIABLES LIKE 'log_replica_updates';
   

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

   SHOW GLOBAL VARIABLES LIKE 'log_slave_updates';
   

6. Verifique se o período de retenção 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, insira 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 fontes do MySQL.