MySQL數據歸檔小工具推薦--mysql_archiver

一.主要概述

MySQL數據庫歸檔歷史數據主要能夠分爲三種方式：一.建立編寫SP、設置Event；二.經過dump導入導出；三.經過pt-archiver工具進行歸檔。第一種方式每每受限於同實例要求，每每被你們捨棄。第二種，性能相對較好，可是歸檔表較多時運維也是比較頭疼的事。因此不少DBA每每採用第三種方式--pt-archiver。

pt-archiver是Percona-Toolkit工具集中的一個組件，是一個主要用於對MySQL表數據進行歸檔和清除的工具。它能夠將數據歸檔到另外一張表或者是一個文件中。pt-archiver在清除表數據的過程當中並不會影響OLTP事務的查詢性能。對於數據的歸檔，它能夠歸檔到另外一臺服務器上的另外一張表，也可歸檔到一個文件中。

有一個網友經過Python開發了將pt-archiver打包成了一個小工具—mysql_archiver，它基本實現了歸檔做業的配置化部署，使用起來挺不錯。"MySQL_archiver基本上實現了數據歸檔的自動運轉，統一的歸檔任務調度管理、自動監控和預警、自動生成報表。在必定程度上節約了生產力，提升了運維效率。"

github地址：https://github.com/dbarun/mysql_archiver

 

二.pt-archiver主要參數

參數	默認值	參數解釋
--check-slave-lag		指定主從複製延遲大於選項'--max-lag'指定的值以後暫停歸檔操做。默認狀況下，工具會檢查全部的從庫，但該選項只做用於指定的從庫(經過DSN鏈接方式)。
--check-interval	1s	若是同時指定了選項'--check-slave-lag'，則該選項指定的時間爲工具發現主從複製延遲時暫停的時間。每進行操做100行時進行一次檢查。
--[no]check-charset	yes	指定檢查確保數據庫鏈接時字符集和表字符集相同。
--commit-each		指定按每次獲取和歸檔的行數進行提交，該選項會禁用選項'--txn-size'。 在每次獲取表數據並進行歸檔以後，在獲取下一次數據和選項'--sleep'指定的休眠時間以前，進行事務提交和刷新選項'--file'指定的文件，經過選項'--limit'控制事務的大小。
--host，-h		指定鏈接的數據庫IP地址。
--port，-P		指定鏈接的數據庫Port端口。
--user，-u		指定鏈接的數據庫用戶。
--password，-p		指定鏈接的數據庫用戶密碼。
--socket，-S		指定使用SOCKET文件鏈接。
--databases，-d		指定鏈接的數據庫
--source		指定須要進行歸檔操做的表，該選項是必須指定的選項，使用DSN方式表示。
--dest		指定要歸檔到的目標端表，使用DSN方式表示。 若是該選項沒有指定的話，則默認與選項'--source'指定源端表爲相同表。
--where		指定經過WHERE條件語句指定須要歸檔的數據，該選項是必須指定的選項。不須要加上'WHERE'關鍵字，若是確實不須要WHERE條件進行限制，則指定'--where 1=1'。
--file		指定表數據須要歸檔到的文件。使用相似MySQL DATE_FORMAT()格式化命名方式。 文件內容與MySQL中SELECT INTO OUTFILE語句使用相同的格式，文件命名選項以下所示： ' %Y：年，4位數(Year, numeric, four digits) %m：月，2位數(Month, numeric (01..12)) %d：日，2位數(Day of the month, numeric (01..31)) %H：小時(Hour (00..23)) %i：分鐘(Minutes, numeric (00..59)) %s：秒(Seconds (00..59)) %D：數據庫名(Database name) %t：表名(Table name) 例如：--file '/var/log/archive/%Y-%m-%d-%D.%t' '
--output-format		指定選項'--file'文件內容輸出的格式。 默認不指定該選項是以製表符進行字段的分隔符，若是指定該選項，則使用','(逗號)做爲字段分隔符，使用'"'(雙引號)將字段括起。用法示例：'--output-format=dump'。
--limit	1	指定每條語句獲取表和歸檔表的行數。
--max-lag	1s	指定容許主從複製延遲時長的最大值，單位秒。若是在每次獲取行數據以後主從延遲超過指定的值，則歸檔操做將暫停執行，暫停休眠時間爲選項'--check-interval'指定的值。待休眠時間結束以後再次檢查主從延遲時長，檢查方法是經過從庫查詢的'Seconds_Behind_Master'值來肯定。若是主從複製延遲一直大於該參數指定值或者從庫中止複製，則操做將一直等待直到從庫從新啓動而且延遲小於該參數指定值.
--no-delete		指定不刪除已被歸檔的表數據。
--progress		指定每多少行打印進度信息，打印當前時間，已用時間以及多少行進行歸檔。
--purge		指定執行的清除操做而不是歸檔操做。容許忽略選項'--dest'和'--file'進行操做，若是隻是清除操做能夠結合選項'--primary-key-only'會更高效。
--replace		指定寫入選項'--dest'指定目標端表時改寫INSERT語句爲REPLACE語句。
--retries	1	指定歸檔操做遇到死鎖或超時的重試次數。當重試次數超過該選項指定的值時，工具將報錯退出。
--run-time		指定工具歸檔操做在退出以前須要運行的時間。容許的時間後綴名爲s=秒，m=分，h=小時，d=天，若是沒指定，默認爲s。
--[no]safe-auto-increment	yes	指定不使用自增列(AUTO_INCREMENT)最大值對應的行進行歸檔。 該選項在進行歸檔清除時會額外添加一條WHERE子句以防止工具刪除單列升序字段具備的具備AUTO_INCREMENT屬性最大值的數據行，爲了在數據庫重啓以後還能使用到AUTO_INCREMENT對應的值，但這會引發沒法歸檔或清除字段對應最大值的行。
--sleep		指定工具在經過SELECT語句獲取歸檔數據須要休眠的時間，默認值是不進行休眠。在休眠以前事務並不會提交，而且選項'--file'指定的文件不會被刷新。若是指定選項'--commit-each'，則在休眠以前會進行事務提交和文件刷新。
--statistics		指定工具收集並打印操做的時間統計信息。
--txn-size	1	指定每一個事務處理的行數。若是是0則禁用事務功能。
--why-quit		指定工具打印當非因完成歸檔行數退出的緣由。 在執行一個自動歸檔任務時該選項與選項'--run-time'一塊兒使用很是方便，這樣能夠肯定歸檔任務是否在指定的時間內完成。若是同時指定了選項'--statistics'，則會打印全部退出的緣由。
--skip-foreign-key-checks		指定使用語句SET FOREIGN_KEY_CHECKS = 0禁用外鍵檢查。

 

三,安裝部署mysql_archiver常見錯誤

1. 執行python db_archive_exec.py 127.0.0.1 db123 報錯

Traceback (most recent call last):
  File "/data/mysql_archiver/mysql_archiver-master/db_archive_exec.py", line 7, in <module>
    import db_conn
  File "/data/mysql_archiver/mysql_archiver-master/db_conn.py", line 4, in <module>
    import MySQLdb
ImportError: No module named MySQLdb

 解決方案:

Step 1 基礎環境

rm -rf /etc/yum.repos.d/epel*
yum install postgresql-devel python3-devel postgresql-devel python-devel

Step 2 安裝setuptools

（1）    下載    setuptools-39.2.0.zip
（2）    解壓安裝 python setup.py build
                python setup.py install

step 3 安裝pip

（1）    下載 pip-1.5.4.tar.gz
（2）    安裝 python setup.py install

step 4 安裝MySQL-python

yum install MySQL-python

 

2.報錯缺乏pt-archiver工具

sh: pt-archiver: command not found

解決方案：

下載percona-toolkit-3.2.1_x86_64.tar.gz,安裝，而且設置個軟鏈接。

例如:

ln -s /data/mysql_archiver/percona-toolkit-3.2.1/bin/pt-archiver /usr/local/bin/pt-archiver

 

3.缺乏文檔

<type 'exceptions.Exception'>
[Errno 2] No such file or directory: u'/software/python_script/db_archive_XXXXdb_XXXtablename.log'

解決方案:

建立文檔: /software/python_script

 

4.字符集問題

Character set mismatch: --source DSN uses utf8, table uses utf8mb4.  You can disable this check by specifying --no-check-charset.

解決方案:

修改db_archive_exec.py可執行文件，針對pt-archiver添加參數 --no-check-charset

 

 5.參數設置報錯

Usage: pt-archiver [OPTIONS] --source DSN --where WHERE

Errors in command-line arguments:
  * --txn-size and --commit-each are mutually exclusive.

pt-archiver nibbles records from a MySQL table.  The --source and --dest
arguments use DSN syntax; if COPY is yes, --dest defaults to the key's value
from --source.  For more details, please use the --help option, or try 'perldoc
/usr/local/bin/pt-archiver' for complete documentation.

 解決方案:

pt-archiver去掉參數 --commit-each

 

 6.Cannot find encoding "utf8mb4"

報錯信息:

Cannot find encoding "utf8mb4" at /usr/local/bin/pt-archiver line 6711.

 解決方案:

pt-archiver去掉參數 --bulk-insert --bulk-delete

 

四.主要參考資料

1.MySQL數據歸檔實戰-Python和pt-archiver的強強結合

https://blog.csdn.net/n88lpo/article/details/78905528?utm_medium=distribute.pc_relevant.none-task-blog-baidulandingword-14&spm=1001.2101.3001.4242

2.MySQL數據歸檔小工具

https://github.com/dbarun/mysql_archiver#readme

3.在linux下安裝MySQLdb及基本操做

https://www.cnblogs.com/blogsme/archive/2012/12/12/2814588.html

4.pt工具之pt-archiver

https://www.cnblogs.com/yhq1314/p/10601801.html

5.linux下pip的安裝步驟及使用詳解

https://www.jb51.net/article/118035.htm

6.Percona-Toolkit 之 pt-archiver 總結

https://www.cnblogs.com/dbabd/p/10721857.html