Binlog 参数检查

最近更新时间:2024-09-02 14:30:32

我的收藏

检查详情

源数据库 binlog 相关参数需要按照如下要求配置,如果校验不通过,请参考本文后续指导进行修复。
log_bin 变量必须设置为 ON
binlog_format 变量必须设置为 ROW
如果源数据库为 MySQL 5.6 及以上版本,gtid_mode 只支持设置为 ONOFF,建议将 gtid_mode 设置为 ON,设置为 OFF 会报警告,设置为 ON_PERMISSIVEOFF_PERMISSIVE 会报错。
server_id 参数需要手动设置,且值不能设置为0。
不允许设置 do_dbignore_db
对于源实例为从库的情况,log_slave_updates 变量必须设置为 ON
建议源库 Binlog 日志至少保留3天及以上,否则可能会因任务暂停/中断时间大于 Binlog 日志保留时间,造成任务无法续传,进而导致任务失败。

修复方法

开启 binlog

log_bin 是 binlog 的开关控制参数,需要将 binlog 打开,以便记录所有的数据库表结构和表数据变更日志。
如发生类似报错,请参考如下指导进行修复:
1. 登录源数据库。
2. 参考如下内容修改源数据库的配置文件 my.cnf
因 log_bin 参数修改后需要重启数据库后才能生效,如果 binlog_format、server_id、binlog_row_image、expire_logs_days 这几个参数也在校验阶段提示报错,请一并修改完成后再重启数据库,让所有参数都生效。
说明:
my.cnf 配置文件的默认路径为 /etc/my.cnf,现场以实际情况为准。
log_bin = MYSQL_BIN
binlog_format = ROW
server_id = 2 //建议设为大于1的整数,此处仅为示例
binlog_row_image = FULL
expire_logs_days = 3 //修改 binlog 的保留时间,建议大于等于3天
3. 参考如下命令重启源数据库。
[$Mysql_Dir]/bin/mysqladmin -u root -p shutdown
[$Mysql_Dir]/bin/safe_mysqld &
说明:
[$Mysql_Dir] 指源数据库的安装路径,请替换为实际的源数据库安装目录。
4. 确认 binlog 功能是否已启用。
show variables like '%log_bin%';
系统显示结果类似如下:
mysql> show variables like '%log_bin%';
+------------------+-------+
| Variable_name | Value |
+------------------+-------+
| log_bin | ON |
+------------------+-------+
1 row in set (0.00 sec)
请使用如下对应的命令查看其他参数的修改结果。
show variables like '%binlog_format%';
show variables like '%binlog_row_image%';
show global variables like '%server_id%';
5. 重新执行校验任务。

修改 binlog_format 参数

binlog_format 为 binlog 的记录模式,有以下三种:
STATEMENT:每一条会修改数据的 SQL 都会记录到 master 的 binlog 中,slave 在复制的时候,会执行和原来 master 端相同的 SQL。该模式可以减少 binlog 日志量,但是对某些特定的函数进行复制时,slave 端不能正确复制。
ROW:binlog 日志中会记录成每一行数据修改的形式,然后在 slave 端再对相同的数据进行修改。该模式会保证 master 和 slave 的正确复制,但是 binlog 日志量会增加。
MIXED:前两种模式的结合,MySQL 会根据执行的每一条具体的 SQL 语句来区分对待记录的日志形式,在 STATEMENTROW 之间选择一种。
综上,为了保证 master 和 slave 的正确复制,binlog_format 参数需要设置为 ROW。如发生类似报错,请参考如下指导进行修复。
说明:
该参数修改需要重置数据库上的所有连接才能生效,当源库为从库时,还需重启主从同步 SQL 线程,避免当前业务连接继续使用修改前的模式写入。
1. 登录源数据库。
2. 参考如下命令修改binlog_format
set global binlog_format = ROW;
3. 重启线程使配置生效,然后通过如下命令查看参数修改是否生效。
show variables like '%binlog_format%';
系统显示结果类似如下:
mysql> show variables like '%binlog_format%';
+---------------+-------+
| Variable_name | Value |
+---------------+-------+
| binlog_format | ROW |
+---------------+-------+
1 row in set (0.00 sec)
4. 重新执行校验任务。

修改 gtid_mode 参数

GTID(Global Transaction Identifier, 全局事务标识),用于在 binlog 中唯一标识一个事务,使用 GTID 可以避免事务重复执行导致数据混乱或者主从不一致。 GTID 是 MySQL 5.6 的新特性,所以 MySQL 5.6 及之后版本存在此问题。DTS 只支持 gtid_mode 设置为 ONOFF,建议将 gtid_mode 设置为 ON,否则校验时会报警告。
警告不影响迁移或同步任务进行,但是会对业务造成一定的影响:设置 GTID 后,在增量数据同步阶段,如果源实例发生 HA 切换,DTS 服务切换重连,任务几乎无感知;反之,任务会中断后失败,且不可恢复。
gtid_mode 的取值如下,在修改 gtid_mode 的值时,只能从以下四个值逐级修改,例如,需要从 OFF 修改为 ON,则 gtid_mode 修改顺序为 OFF <-> OFF_PERMISSIVE <-> ON_PERMISSIVE <-> ON
OFF:主库所有新启的事务以及从库的事务都要求是匿名事务。
OFF_PERMISSIVE:主库新启的事务是匿名事务,但从库事务允许是匿名的或者是 GTID 事务,但不允许只是 GTID 模式。
ON_PERMISSIVE:主库新启的事务是 GTID 事务,从库事务允许是匿名的或者是 GTID 事务。
ON:主库新启的事务是 GTID 事务,从库的事务也要求是 GTID 事务。
如果发生类似警告,请按照如下指导进行修复:
1. 登录源数据库。
2. 在主从复制结构两边都设置 gtid_mode = OFF_PERMISSIVE。 MySQL 5.7.6 之前的版本需要在my.cnf 配置文件中修改并重启数据库才能生效,5.7.6 及之后的版本通过全局命名修改,不需要重启数据库,但是需要重置所有业务连接。
set global gtid_mode = OFF_PERMISSIVE;
3. 在主从复制结构两边都设置 gtid_mode = ON_PERMISSIVE
set global gtid_mode = ON_PERMISSIVE;
4. 在各个实例节点上执行如下命令,检查匿名事务是否消耗完毕,参数值为0则代表消耗完毕。
show variables like '%ONGOING_ANONYMOUS_TRANSACTION_COUNT%';
系统显示结果类似如下:
mysql> show variables like '%ONGOING_ANONYMOUS_TRANSACTION_COUNT%';
+-------------------------------------+-------+
| Variable_name | Value |
+-------------------------------------+-------+
| Ongoing_anonymous_transaction_count | 0 |
+-------------------------------------+-------+
1 row in set (0.00 sec)
5. 在主从复制结构两边都设置 gtid_mode = ON
set global gtid_mode = ON;
6. my.cnf 文件中添加如下内容,后续重启数据库后使初始值生效。
说明:
my.cnf 配置文件的默认路径为 /etc/my.cnf,现场以实际情况为准。
gtid_mode = on
enforce_gtid_consistency = on
7. 重新执行校验任务。

修改 server_id 参数

server_id 参数需要手动设置,且值不能设置为0。该参数系统预设值为1,如果查询该参数显示为1不一定正确,需要手动进行配置。
1. 登录源数据库。
2. 参考如下内容修改 server_id
set global server_id = 2; //建议设为大于1的整数,此处仅为示例
3. 通过如下命令查看参数修改是否生效。
show global variables like '%server_id%';
系统显示结果类似如下:
mysql> show global variables like '%server_id%';
+---------------+-------+
| Variable_name | Value |
+---------------+-------+
| server_id | 2 |
+---------------+-------+
1 row in set (0.00 sec)
4. 重新执行校验任务。

删除 do_db,ignore_db 设置

binlog 会记录数据库所有执行的 DDL 和 DML 语句,而 do_db,ignore_db 则是设置 binlog 记录的过滤条件。
binlog_do_db:只记录指定数据库的二进制日志,默认全部记录。
binlog_ignore_db:不记录指定的数据库的二进制日志。
设置 do_db,ignore_db 后,会导致一些跨库操作 binlog 记录不全,主从复制出现异常,因此不建议设置。如发生类似报错,请参考如下指导进行修复:
1. 登录源数据库。
2. 修改源数据库的配置文件 my.cnf,删除 do_db,ignore_db相关设置。
说明:
my.cnf 配置文件的默认路径为 /etc/my.cnf,现场以实际情况为准。
3. 参考如下命令重启源数据库。
[$Mysql_Dir]/bin/mysqladmin -u root -p shutdown
[$Mysql_Dir]/bin/safe_mysqld &
说明:
[$Mysql_Dir] 指源数据库的安装路径,请替换为实际的源数据库安装目录。
4. 确认参数修改是否生效。
show master status;
系统显示结果类似如下:
mysql> show master status;
+---------------+----------+--------------+------------------+-------------------+
| File | Position | Binlog_Do_DB | Binlog_Ignore_DB | Executed_Gtid_Set |
+---------------+----------+--------------+------------------+-------------------+
| binlog.000011 | 154 | | | |
+---------------+----------+--------------+------------------+-------------------+
5. 重新执行校验任务。

修改 log_slave_updates 参数

在主从复用结构中,从库开启 log-bin 参数,直接在从库操作数据时,可以记录在 binlog 中,但是从库从主库上复制数据时,不能记录在 binlog 中,所以从库作为其他从库的主库时,需要打开 log_slave_updates 参数。
1. 登录源数据库。
2. 在源数据库的配置文件 my.cnf 中增加如下内容。
说明:
my.cnf 配置文件的默认路径为 /etc/my.cnf,现场以实际情况为准。
log_slave_updates = ON
3. 参考如下命令重启源数据库。
[$Mysql_Dir]/bin/mysqladmin -u root -p shutdown
[$Mysql_Dir]/bin/safe_mysqld &
说明:
[$Mysql_Dir] 指源数据库的安装路径,请替换为实际的源数据库安装目录。
4. 查看配置是否生效。
show variables like '%log_slave_updates%';
系统显示结果类似如下:
mysql> show variables like '%log_slave_updates%';
+-------------------+-------+
| Variable_name | Value |
+-------------------+-------+
| log_slave_updates | ON |
+-------------------+-------+
1 row in set (0.00 sec)
5. 重新执行校验任务。