为 CDC 配置自行管理的 MySQL 数据库

本页面介绍如何配置变更数据捕获 (CDC)，以将数据从自管理的 MySQL 数据库流式传输到支持的目标位置，例如 BigQuery 或 Cloud Storage。这些说明也适用于 MariaDB、Percona Server for MySQL 或 Alibaba Cloud PolarDB 等数据库。

验证二进制日志的配置和保留期限

1. 输入以下 MySQL 命令，确认二进制日志已正确配置：

   SHOW GLOBAL VARIABLES LIKE '%binlog_format%';
   

2. 验证 binlog_format 变量的值是否设置为 ROW。 Datastream 不支持 MIXED 或 STATEMENT 二进制日志格式。

3. 输入以下 MySQL 命令，确认二进制日志的行格式设置为 FULL：

   SHOW GLOBAL VARIABLES LIKE 'binlog_row_image';
   

4. 输入以下 MySQL 命令，验证二进制日志的副本更新选项设置为 ON：

   SHOW GLOBAL VARIABLES LIKE 'log_replica_updates';
   

   对于 8.0.26 之前的 MySQL 版本，请改为输入以下命令：

   SHOW GLOBAL VARIABLES LIKE 'log_slave_updates';
   

5. 输入以下 MySQL 命令，验证二进制日志的保留期限是否设置为 604800 秒（7 天）：

   SHOW GLOBAL VARIABLES LIKE 'binlog_expire_logs_seconds';
   

   对于 8.0.3 之前的 MySQL 版本，请改为输入以下命令：

   SHOW GLOBAL VARIABLES LIKE 'expire_logs_days';
   

   如果您的 MySQL 数据库未设置为全行复制和 7 天的保留期限，则需要更改二进制日志的配置，如下所示：

   1. 导航到 /etc/mysql/ 目录。
   2. 使用编辑器打开 my.cnf 文件。
   3. 将以下代码行添加到文件中：

        [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. 对于基于 GTID 的复制，还需添加以下几行代码：

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

   5. 保存对 my.cnf 文件所做的更改，然后关闭该文件。
   6. 重启 MySQL 服务器，使您所做的更改生效。

创建 Datastream 用户

1. 如需创建 DataStream 用户，请输入以下 MySQL 命令：

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

后续步骤

• 详细了解 Datastream 如何与 MySQL 源搭配使用。