Ajout section

HowtoMySQL/Percona.md

@@ -7,6 +7,56 @@ Le guide d'installation et d'usage courant, voir [HowtoMySQL](/HowtoMySQL).
 
 La documentation sur [Percona](https://www.percona.com/software/documentation).
 
+
+## Contrôle intégrité d'une réplication
+
+#### pt-table-checksum
+
+<https://www.percona.com/doc/percona-toolkit/2.1/pt-table-checksum.html>
+
+C'est un outil de [Percona](https://www.percona.com/downloads/percona-toolkit/) intégré dans son toolkit. (Package Debian [percona-toolkit](https://packages.debian.org/search?keywords=percona-toolkit) disponible à partir de Wheezy).
+
+L'outil vérifie l'intégrité de la réplication en effectuant des requêtes de checksum (crc32 par défaut) sur le master, puis les requêtes sont joués sur les slaves permettant de trouver des différences.
+
+La méthode la plus simple pour l'utiliser est d'autoriser le master à se connecter au slave (authentification MySQL). Ainsi, il s'occupe lui-même de faire le nécessaire pour identifier les erreurs. Il suffira donc de lancer la commande sans argument pour qu'il identifie les incohérences. On pourra réaliser un cron avec l'argument `-q` qui ne fait remonter que les erreurs.
+
+~~~
+MAILTO=jdoe@example.com
+42 9 * * 7 pt-table-checksum -q
+~~~
+
+Si on veut afficher seulement les différences on peut utiliser l'option `--replicate-check-only` exemple avec un pt-table-checksum sur une base en particulier:
+
+~~~
+# pt-table-checksum --replicate-check-only --databases foo
+~~~
+
+### pt-table-sync
+
+Si *pt-table-checksum* vous a remonté des incohérences, vous pouvez avec cet outil les corriger. Cela va identifier les différences et les corriger avec un `REPLACE` sur le master (qui sera donc répliqué sur le slave), garantissant la cohérence des données.
+
+Exemple :
+
+~~~
+# pt-table-sync --print --replicate percona.checksums localhost
+# pt-table-sync --execute --replicate percona.checksums localhost
+~~~
+
+En cas de `Can't make changes on the master because no unique index exists`. On peut synchroniser directement les différences sur le slave depuis le master.
+
+~~~
+# pt-table-sync --execute --no-check-slave localhost slave
+~~~
+
+#### Erreur "CRC32 never needs BIT_XOR optimization at /usr/bin/pt-table-*"
+
+Avec MariaDB 10.3 il y a un souci avec la version du paquet debian de percona-toolkit, si vous avez une erreur de "CRC32 never needs BIT_XOR optimization" il faut passer en version MD5 comme ceci :
+
+~~~
+# pt-table-checksum -q --function MD5
+~~~
+
+
 ## Monitoring d'une réplication
 
 ### pt-heartbeat