Percona-Toolkit 之 pt-archiver

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

--analyze

指定工具完成資料歸檔後對錶執行'ANALYZE TABLE'操作。指定方法如'--analyze=ds'，s代表源端表，d代表目標端表，也可以單獨指定。

--ask-pass

命令列提示密碼輸入，保護密碼安全，前提需安裝模組perl-TermReadKey。

--buffer

指定緩衝區資料重新整理到選項'--file'指定的檔案並且在提交時重新整理。

只有當事務提交時禁用自動重新整理到'--file'指定的檔案和重新整理檔案到磁碟，這意味著檔案是被作業系統塊進行重新整理，因此在事務進行提交之前有一些資料隱式重新整理到磁碟。預設是每一行操作後進行檔案重新整理到磁碟。

--bulk-delete

指定單個語句刪除chunk的方式來批次刪除行，會隱式執行選項'--commit-each'。

使用單個DELETE語句刪除每個chunk對應的錶行，通常的做法是透過主鍵進行逐行的刪除，批次刪除在速度上會有很大的提升，但如果有複雜的'WHERE'條件就可能會更慢。

--[no]bulk-delete-limit

預設值：yes

指定新增選項'--bulk-delete'和'--limit'到進行歸檔的語句中。

--bulk-insert

使用LOAD DATA LOCAL INFILE的方法，透過批次插入chunk的方式來插入行(隱式指定選項'--bulk-delete'和'--commit-each')

而不是透過逐行單獨插入的方式進行，它比單行執行INSERT語句插入的速度要快。透過隱式建立臨時表來儲存需要批次插入的行(chunk)，而不是直接進行批次插入操作，當臨時表中完成每個chunk之後再進行統一資料載入。為了保證資料的安全性，該選項會強制使用選項'--bulk-delete'，這樣能夠有效保證刪除是在插入完全成功之後進行的。

--channel

指定當主從複製環境是多源複製時需要進行歸檔哪個主庫的資料，適用於多源複製中多個主庫對應一個從庫的情形。

--charset，-A

指定連線字符集。

--[no]check-charset

預設值：yes

指定檢查確保資料庫連線時字符集和表字符集相同。

--[no]check-columns

預設值：yes

指定檢查確保選項'--source'指定的源端表和'--dest'指定的目標表具有相同的欄位。

不檢查欄位在表的排序和欄位型別，只檢查欄位是否在源端表和目標表當中都存在，如果有不相同的欄位差異，則工具報錯退出。如果需要禁用該檢查，則指定'--no-check-columns'。

--check-slave-lag

指定主從複製延遲大於選項'--max-lag'指定的值之後暫停歸檔操作。預設情況下，工具會檢查所有的從庫，但該選項只作用於指定的從庫(透過DSN連線方式)。

--check-interval

預設值：1s

如果同時指定了選項'--check-slave-lag'，則該選項指定的時間為工具發現主從複製延遲時暫停的時間。每進行操作100行時進行一次檢查。

--columns，-c

指定需要歸檔的表欄位，如有多個則用','(逗號)隔開。

--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'。

--for-update

指定為每次歸檔執行的SELECT語句新增FOR UPDATE子句。

--share-lock

指定為每次歸檔執行的SELECT語句新增LOCK IN SHARE MODE子句。

--header

指定在檔案中第一行寫入欄位名稱作為標題。

--ignore

指定為INSERT語句新增IGNORE選項。

--limit

預設值：1

指定每條語句獲取表和歸檔表的行數。

--local

指定不將OPTIMIZE和ANALYZE語句寫入binlog。

--max-lag

預設值：1s

指定允許主從複製延遲時長的最大值，單位秒。如果在每次獲取行資料之後主從延遲超過指定的值，則歸檔操作將暫停執行，暫停休眠時間為選項'--check-interval'指定的值。待休眠時間結束之後再次檢查主從延遲時長，檢查方法是透過從庫查詢的'Seconds_Behind_Master'值來確定。如果主從複製延遲一直大於該引數指定值或者從庫停止複製，則操作將一直等待直到從庫重新啟動並且延遲小於該引數指定值。

--no-delete

指定不刪除已被歸檔的表資料。

--optimize

指定工具完成資料歸檔後對錶執行'OPTIMIZE TABLE'操作。指定方法如'--analyze=ds'，s代表源端表，d代表目標端表，也可以單獨指定。

--primary-key-only

指定只歸檔主鍵欄位，是選項'--columns=主鍵'的簡寫。

如果工具歸檔的操作是進行DELETE清除時最有效，因為只需讀取主鍵一個欄位而無需讀取行所有欄位。

--progress

指定每多少行列印進度資訊，列印當前時間，已用時間以及多少行進行歸檔。

--purge

指定執行的清除操作而不是歸檔操作。允許忽略選項'--dest'和'--file'進行操作，如果只是清除操作可以結合選項'--primary-key-only'會更高效。

--quiet，-q

指定工具靜默執行，不輸出任何的執行資訊。

--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對應的值，但這會引起無法歸檔或清除欄位對應最大值的行。

--set-vars

預設：

    wait_timeout=10000

    innodb_lock_wait_timeout=1

    lock_wait_timeout=60

工具歸檔時指定引數值，如有多個用','(逗號)分隔。如'--set-vars=wait_timeout=5000'。

--skip-foreign-key-checks

指定使用語句SET FOREIGN_KEY_CHECKS = 0禁用外來鍵檢查。

--sleep

指定工具在透過SELECT語句獲取歸檔資料需要休眠的時間，預設值是不進行休眠。在休眠之前事務並不會提交，並且選項'--file'指定的檔案不會被重新整理。如果指定選項'--commit-each'，則在休眠之前會進行事務提交和檔案重新整理。

--statistics

指定工具收集並列印操作的時間統計資訊。

統計資訊示例如下：

'

Started at 2008-07-18T07:18:53, ended at 2008-07-18T07:18:53

Source: D=db,t=table

SELECT 4

INSERT 4

DELETE 4

Action         Count       Time        Pct

commit            10     0.1079      88.27

select             5     0.0047       3.87

deleting           4     0.0028       2.29

inserting          4     0.0028       2.28

other              0     0.0040       3.29

'

--txn-size

預設：1

指定每個事務處理的行數。如果是0則禁用事務功能。

--version

顯示工具的版本並退出。

--[no]version-check

預設值：yes

檢查Percona Toolkit、MySQL和其他程式的最新版本。

--why-quit

指定工具列印當非因完成歸檔行數退出的原因。

在執行一個自動歸檔任務時該選項與選項'--run-time'一起使用非常方便，這樣可以確定歸檔任務是否在指定的時間內完成。如果同時指定了選項'--statistics'，則會列印所有退出的原因。