使用pt-table-checksum校验MySQL主从复制

pt-table-checksum是一个基于MySQL数据库主从架构在线数据一致性校验工具。其工作原理在主库上运行， 通过对同步的表在主从段执行checksum， 从而判断数据是否一致。在校验完毕时，该工具将列出与主库存在差异的对象结果。

一、主从不一致的情形

    Master端使用了不确定的语句(如:CURRENT_USER(), UUID())    不正确的故障转移(failover)流程    误操作或直接在Slave进行DML操作    持续的升级更新(Rolling upgrades)    混合使用事务引擎和非事务引擎的表    跳过了复制事件 (SET GLOBAL SQL_SLAVE_SKIP_COUNTER = N)    使用临时表(Temporary Tables)    复制过滤(Replication Filters)    使用含LIMIT且没有order by的更新语句(update/delete with LIMIT clause without order by)

二、pt-table-checksum特性

    pt-table-checksum connects to the server you specify, and finds databases and tables that     match the filters you specify  (if any). It works one table at a time, so it does not accumulate    large amounts of memory or do a lot of work before beginning to checksum. This makes it usable    on very large servers. We have used it on servers with hundreds of thousands of databases and tables,     and trillions of rows. No matter how large the server is, pt-table-checksum works equally well.    One reason it can work on very large tables is that it divides each table into chunks of rows,     and checksums each chunk with a single REPLACE..SELECT query. It varies the chunk size to make     the checksum queries run in the desired amount of time. The goal of chunking the tables, instead of     doing each table with a single big query, is to ensure that checksums are unintrusive and don’t cause too    much replication lag or load on the server. That’s why the target time for each chunk is 0.5 seconds by default.    The tool keeps track of how quickly the server is able to execute the queries, and adjusts the chunks     as it learns more about the server’s performance. It uses an exponentially decaying weighted average     to keep the chunk size stable, yet remain responsive if the server’s performance changes during checksumming     for any reason. This means that the tool will quickly throttle itself if your server becomes heavily loaded during     a trafficc spike or a background task, for example.    After pt-table-checksum finishes checksumming all of the chunks in a table, it pauses and waits for all     detected replicas to finish executing the checksum queries. Once that is finished, it checks all of the replicas to     see if they have the same data as the master, and then prints a line of output with the results. 

三、演示pt-table-checksum

-- 环境：Master 192.168.1.8， Slave 192.168.1.12，主从已构建-- 演示中，mysql提示符为：用户名@主机名[库名]-- 如master@localhost[test]，表示master用户表示在主，slave表示用户在slave上-- 复制过滤器如下：[root@vdbsrv4 ~]# mysql -uroot -p -e "show slave status\G"|grep "ReplicateEnter password:               Replicate_Do_DB: sakila,test          Replicate_Ignore_DB: mysqla、环境准备--对用于执行checksum的用户授权，注，如果主从复制未开启mysql系统库复制，则从库也同样执行用户创建master@localhost[test]> grant select, process, super, replication slave on *.* to ->  'checksums'@'192.168.1.%' identified by 'xxx';Query OK, 0 rows affected (0.00 sec)--主库建表及插入记录master@localhost[test]> create table t(id tinyint primary key auto_increment,ename varchar(20));Query OK, 0 rows affected (0.01 sec)master@localhost[test]> insert into t(ename) values('Leshami'),('Henry'),('Jack');Query OK, 3 rows affected (0.01 sec)Records: 3  Duplicates: 0  Warnings: 0--从库查询结果slave@localhost[test]> select * from t;+----+---------+| id | ename  |+----+---------+|  1 | Leshami ||  2 | Henry  ||  3 | Jack    |+----+---------+--模拟数据不一致,slave端删除记录slave@localhost[test]> delete from t where id=2;b、单表校验-- 执行pt-table-checksum[root@vdbsrv3 ~]# pt-table-checksum h='192.168.1.8',u='checksums',p='xxx',P=3306 \> -dtest -tt --nocheck-replication-filters \> --no-check-binlog-format  --replicate=test.checksum            TS ERRORS  DIFFS    ROWS  CHUNKS SKIPPED    TIME TABLE08-06T10:14:32      0      1        3      1      0  0.031 test.tTS            ：完成检查的时间。ERRORS        ：检查时候发生错误和警告的数量。DIFFS        ：0表示一致，1表示不一致。当指定--no-replicate-check时，                会一直为0，当指定--replicate-check-only会显示不同的信息。ROWS          ：表的行数。CHUNKS        ：被划分到表中的块的数目。SKIPPED      ：由于错误或警告或过大，则跳过块的数目。TIME          ：执行的时间。TABLE        ：被检查的表名。--基于从库端SQL脚本查看checksum结果slave@localhost[test]> system more check_sync_stat.sql;SELECT     db, tbl, SUM(this_cnt) AS total_rows, COUNT(*) AS chunksFROM    test.checksumWHERE    (master_cnt <> this_cnt        OR master_crc <> this_crc        OR ISNULL(master_crc) <> ISNULL(this_crc))GROUP BY db , tbl;slave@localhost[test]> source check_sync_stat.sql;+------+-----+------------+--------+| db  | tbl | total_rows | chunks |+------+-----+------------+--------+| test | t  |          2 |      1 |+------+-----+------------+--------+--从库端插入记录slave@localhost[test]> insert into t(ename) values('Robin');Query OK, 1 row affected (0.00 sec)slave@localhost[test]> select * from t;+----+---------+| id | ename  |+----+---------+|  1 | Leshami |   #Author : Leshami|  3 | Jack    |   #Blog     : http://blog.csdn.net/leshami|  4 | Robin  |+----+---------+-- 再次在master端执行pt-table-checksum(此处略)，后查看结果如下slave@localhost[test]> source check_sync_stat.sql;+------+-----+------------+--------+| db  | tbl | total_rows | chunks |+------+-----+------------+--------+| test | t  |          3 |      1 |+------+-----+------------+--------+b、查看pt-table-checksum工作原理-- 使用--explain参数，不执行checksum，列出checksum时真正执行的SQL语句Show, but do not execute, checksum queries (disables --[no]empty-replicate-table). If specifedtwice, the tool actually iterates through the chunking algorithm, printing the upper and lower boundary valuesfor each chunk, but not executing the checksum queries.[root@vdbsrv3 ~]# pt-table-checksum h='192.168.1.8',u='checksums',p='xxx',P=3306 \> -dtest -tt --nocheck-replication-filters \> --no-check-binlog-format  --replicate=test.checksum --explain---- test.t--REPLACE INTO `test`.`checksum` (db, tbl, chunk, chunk_index, lower_boundary,upper_boundary, this_cnt, this_crc) SELECT ?, ?, ?, ?, ?, ?, COUNT(*) AS cnt, COALESCE(LOWER(CONV(BIT_XOR(CAST(CRC32(CONCAT_WS('#', `id`, `ename`, CONCAT(ISNULL(`ename`)))) AS UNSIGNED)), 10, 16)), 0) AS crc FROM `test`.`t`  /*checksum table*/c、库级别校验[root@vdbsrv3 ~]# pt-table-checksum h='192.168.1.8',u='checksums',p='xxx',P=3306 \> --databases=sakila --nocheck-replication-filters --no-check-binlog-format \> --replicate=test.checksum             TS ERRORS  DIFFS    ROWS  CHUNKS SKIPPED    TIME TABLE08-06T13:52:17      0      0      200      1      0  0.083 sakila.actor08-06T13:52:17      0      0      603      1      0  0.024 sakila.address08-06T13:52:17      0      0      16      1      0  0.012 sakila.category08-06T13:52:17      0      0      600      1      0  0.025 sakila.city08-06T13:52:17      0      0      109      1      0  0.019 sakila.country08-06T13:52:17      0      0      599      1      0  0.019 sakila.customer08-06T13:52:17      0      0    1000      1      0  0.035 sakila.film08-06T13:52:17      0      0    5462      1      0  0.295 sakila.film_actor08-06T13:52:17      0      0    1000      1      0  0.019 sakila.film_category08-06T13:52:17      0      0    1000      1      0  0.015 sakila.film_text08-06T13:52:17      0      0    4581      1      0  0.041 sakila.inventory08-06T13:52:17      0      0        6      1      0  0.012 sakila.language08-06T13:52:18      0      0    16049      1      0  0.367 sakila.payment08-06T13:52:18      0      0    16044      1      0  0.357 sakila.rental08-06T13:52:18      0      0        2      1      0  0.013 sakila.staff08-06T13:52:18      0      0        2      1      0  0.012 sakila.store--在从库删除一张表slave@localhost[test]> drop table sakila.payment;Query OK, 0 rows affected (0.01 sec)-- 再次执行pt-table-checksum，收到如下提示08-06T13:56:42 Skipping table sakila.payment because it has problems on these replicas:Table sakila.payment does not exist on replica vdbsrv4This can break replication.  If you understand the risks, specify --no-check-slave-tables to disable this check.08-06T13:56:42 Error checksumming table sakila.payment: DBD::mysql::db selectrow_hashref failed:Table 'sakila.payment' doesn't exist [for Statement "EXPLAIN SELECT * FROM `sakila`.`payment` WHERE 1=1"] at /usr/bin/pt-table-checksum line 6530.d、多从校验-- 下面演示多个从库时主从一致性校验-- 缺省情况下-- 参数：--recursion-method ; type: array; default: processlist,hosts.--            Preferred recursion method for discovering replicas.--  pt-table-checksum performs several “REPLICACHECKS” before and while running.master@localhost[(none)]> show slave hosts;+-----------+------+------+-----------+--------------------------------------+| Server_id | Host | Port | Master_id | Slave_UUID                          |+-----------+------+------+-----------+--------------------------------------+|        11 |      | 3307 |      1002 | 69fc46b6-3c06-11e5-94f0-000c29a05f26 ||        1 |      | 3306 |      1002 | f2824060-e2cb-11e4-8f18-000c2926f457 |+-----------+------+------+-----------+--------------------------------------+root@localhost[(none)]> show variables like 'port';+---------------+-------+| Variable_name | Value |+---------------+-------+| port          | 3307  |+---------------+-------+root@localhost[(none)]> delete from test.t where id=1;Query OK, 1 row affected (0.00 sec)[root@vdbsrv3 ~]# pt-table-checksum h='192.168.1.8',u='checksums',p='xxx',P=3306 -dtest \> -tt --nocheck-replication-filters --no-check-binlog-format --replicate=test.checksum \> --recursion-method=hosts# A software update is available:#  * The current version for Percona::Toolkit is 2.2.14.            TS ERRORS  DIFFS    ROWS  CHUNKS SKIPPED    TIME TABLE08-06T16:12:52      0      1        3      1      0  0.034 test.t

四、参数描述

–nocheck-replication-filters
  不检查复制过滤器，建议启用。后面可以用–databases来指定需要检查的数据库。
–no-check-binlog-format
  不检查复制的binlog模式，要是binlog模式是ROW，则会报错。
–replicate-check-only
  只显示不同步的信息。
–replicate=
  把checksum的信息写入到指定表中，建议直接写到被检查的数据库当中。
–databases=
  指定需要被检查的数据库，多个则用逗号隔开。
–tables=
  指定需要被检查的表，多个用逗号隔开
  h=127.0.0.1 ：Master的地址
  u=root ：用户名
  p=123456 ：密码
  P=3306 ：端口

五、常见问题

[root@vdbsrv3 ~]# pt-table-checksum h='192.168.1.8',u='checksums',p='xxx',P=3306 -d mysql \> --nocheck-replication-filters --replicate=test.checksumsReplica vdbsrv4 has binlog_format MIXED which could cause pt-table-checksum to break replication. Please read "Replicas using row-based replication" in the LIMITATIONS section of the tool's documentation.  If you understand the risks, specify --no-check-binlog-format to disable this check.上面描述的是关于使用mixed日志格式时的问题  [root@vdbsrv3 ~]# pt-table-checksum h='192.168.1.8',u='checksums',p='xxx',P=3306 -d mysql \> --nocheck-replication-filters --no-check-binlog-formatDBD::mysql::db do failed: Access denied for user 'checksums'@'192.168.1.%' to database 'percona' [for Statement "CREATE DATABASE IF NOT EXISTS `percona` /* pt-table-checksum */"] at /usr/bin/pt-table-checksum line 10743.07-29T08:42:03 --replicate database percona does not exist and it cannot be created automatically. You need to create the database.[root@vdbsrv3 ~]# pt-table-checksum h='192.168.1.8',u='checksums',p='xxx',P=3306 -dtest -tt \> --nocheck-replication-filters --no-check-binlog-format  --replicate=test.checksumCannot connect to P=3306,h=vdbsrv4,p=...,u=checksumsDiffs cannot be detected because no slaves were found.  Please read the --recursion-method documentation for information.            TS ERRORS  DIFFS    ROWS  CHUNKS SKIPPED    TIME TABLE08-06T10:03:10      0      0        3      1      0  0.023 test.t[root@vdbsrv3 ~]# pt-table-checksum h='192.168.1.8',u='checksums',p='xxx',P=3306 -dtest -tt \> --nocheck-replication-filters --no-check-binlog-format \> --replicate=test.checksum --recursion-method=hostsCannot connect to P=3306,h=,p=...,u=checksumsCannot connect to P=3307,h=,p=...,u=checksumsDiffs cannot be detected because no slaves were found.  Please read the --recursion-method documentation for information.            TS ERRORS  DIFFS    ROWS  CHUNKS SKIPPED    TIME TABLE08-06T16:02:27      0      0        3      1      0  0.016 test.tmaster@localhost[(none)]> show slave hosts;+-----------+------+------+-----------+--------------------------------------+| Server_id | Host | Port | Master_id | Slave_UUID                          |+-----------+------+------+-----------+--------------------------------------+|        1 |      | 3306 |      1002 | f2824060-e2cb-11e4-8f18-000c2926f457 ||        11 |      | 3307 |      1002 | 69fc46b6-3c06-11e5-94f0-000c29a05f26 |+-----------+------+------+-----------+--------------------------------------+-- 增加参数report_host后重启从库[root@vdbsrv4 ~]# grep report_host /etc/my.cnfreport_host='192.168.1.12'master@localhost[(none)]> show slave hosts;+-----------+--------------+------+-----------+--------------------------------------+| Server_id | Host        | Port | Master_id | Slave_UUID                          |+-----------+--------------+------+-----------+--------------------------------------+|        11 | 192.168.1.12 | 3307 |      1002 | 69fc46b6-3c06-11e5-94f0-000c29a05f26 ||        1 | 192.168.1.12 | 3306 |      1002 | f2824060-e2cb-11e4-8f18-000c2926f457 |+-----------+--------------+------+-----------+--------------------------------------+