小 T 導(dǎo)讀：為了讓大家更好地進(jìn)行 TDengine 集群間的備份和遷移工作，一款名為 taosdump 的工具應(yīng)用程序被打造出來(lái)。在本篇文章中，我們對(duì) taosdump 的使用方法和注意事項(xiàng)進(jìn)行了相關(guān)匯總，給到有需要的開(kāi)發(fā)者。

作為 TDengine 的一款工具應(yīng)用程序，taosdump 支持從運(yùn)行中的 TDengine 集群備份數(shù)據(jù)，并將備份的數(shù)據(jù)恢復(fù)到相同或另一個(gè)運(yùn)行中的 TDengine 集群中，其使用 Apache AVRO（https://avro.apache.org/）作為數(shù)據(jù)文件格式來(lái)存儲(chǔ)備份數(shù)據(jù)。

值得一提的是，taosdump 可以用 Database、超級(jí)表或普通表作為邏輯數(shù)據(jù)單元進(jìn)行備份，也可以對(duì) Database、超級(jí)表和普通表中指定時(shí)間段內(nèi)的數(shù)據(jù)記錄進(jìn)行備份。在使用時(shí)，我們可以對(duì) taosdump 指定數(shù)據(jù)備份的目錄路徑；如果不指定位置，它就會(huì)默認(rèn)將數(shù)據(jù)備份到當(dāng)前目錄；如果指定的位置已經(jīng)有數(shù)據(jù)文件，taosdump 會(huì)提示用戶并立即退出，避免數(shù)據(jù)被覆蓋。這意味著同一路徑只能被用于一次備份。如果大家看到相關(guān)提示，務(wù)必小心操作。

但需要注意的是，taosdump 是一個(gè)邏輯備份工具，它不應(yīng)被用于備份任何原始數(shù)據(jù)、環(huán)境設(shè)置、 硬件信息、服務(wù)端配置或集群的拓?fù)浣Y(jié)構(gòu)。

安裝

taosdump 有以下兩種安裝方式：

• 安裝 taosTools 官方安裝包，你可以進(jìn)入 http://www.fjzmyy.cn/all-downloads 此頁(yè)面找到 taosTools 并進(jìn)行下載安裝。
• 單獨(dú)編譯 taosTools 并安裝，詳情請(qǐng)參考 taos-tools 倉(cāng)庫(kù)（https://github.com/taosdata/taos-tools）。

常用使用場(chǎng)景

taosdump 備份數(shù)據(jù)

1. 備份所有數(shù)據(jù)庫(kù)：指定 -A 或 --all-databases 參數(shù)；
2. 備份多個(gè)指定數(shù)據(jù)庫(kù)：使用 -D db1,db2,... 參數(shù)；
3. 備份指定數(shù)據(jù)庫(kù)中的某些超級(jí)表或普通表：使用 dbname stbname1 stbname2 tbname1 tbname2 ... 參數(shù)，注意這種輸入序列第一個(gè)參數(shù)為數(shù)據(jù)庫(kù)名稱(chēng)，且只支持一個(gè)數(shù)據(jù)庫(kù)，第二個(gè)和之后的參數(shù)為該數(shù)據(jù)庫(kù)中的超級(jí)表或普通表名稱(chēng)，中間以空格分隔；
4. 備份系統(tǒng) log 庫(kù)：TDengine 集群通常會(huì)包含一個(gè)系統(tǒng)數(shù)據(jù)庫(kù)，名為 log，這個(gè)數(shù)據(jù)庫(kù)內(nèi)的數(shù)據(jù)為 TDengine 自我運(yùn)行的數(shù)據(jù)，taosdump 默認(rèn)不會(huì)對(duì) log 庫(kù)進(jìn)行備份。如果有特定需求對(duì) log 庫(kù)進(jìn)行備份，可以使用 -a 或 --allow-sys 命令行參數(shù)。
5. “寬容”模式備份：taosdump 1.4.1 之后的版本提供 -n 參數(shù)和 -L 參數(shù)，用于備份數(shù)據(jù)時(shí)不使用轉(zhuǎn)義字符和“寬容”模式，可以在表名、列名、標(biāo)簽名沒(méi)使用轉(zhuǎn)義字符的情況下減少備份數(shù)據(jù)時(shí)間和備份數(shù)據(jù)占用空間。如果不確定是否符合使用 -n 和 -L 條件時(shí)，請(qǐng)使用默認(rèn)參數(shù)進(jìn)行“嚴(yán)格”模式進(jìn)行備份。轉(zhuǎn)義字符的說(shuō)明請(qǐng)參考官方文檔（https://docs.taosdata.com/taos-sql/escape/）。

需要注意

• taosdump 1.4.1 之后的版本提供 -I 參數(shù)，用于解析 avro 文件 schema 和數(shù)據(jù)，如果指定 -s 參數(shù)將只解析 schema。
• taosdump 1.4.2 之后的備份使用 -B 參數(shù)指定的批次數(shù)，默認(rèn)值為 16384，如果在某些環(huán)境下由于網(wǎng)絡(luò)速度或磁盤(pán)性能不足導(dǎo)致 “Error actual dump .. batch ..” ，可以通過(guò) -B 參數(shù)調(diào)整為更小的值進(jìn)行嘗試。
• taosdump 的導(dǎo)出不支持中斷恢復(fù)，所以當(dāng)進(jìn)程意外終止后，正確的處理方式是刪除當(dāng)前已導(dǎo)出或生成的所有相關(guān)文件。
• taosdump 的導(dǎo)入支持中斷恢復(fù)，但是當(dāng)進(jìn)程重新啟動(dòng)時(shí)，會(huì)收到一些“表已經(jīng)存在”的提示，可以忽視。

taosdump 恢復(fù)數(shù)據(jù)

如果我們想要恢復(fù)指定路徑下的數(shù)據(jù)文件，方式是：使用 -i 參數(shù)加上數(shù)據(jù)文件所在路徑。如前文提及，我們不能使用同一個(gè)目錄備份不同數(shù)據(jù)集合，也不能在同一路徑多次備份同一數(shù)據(jù)集，否則備份數(shù)據(jù)會(huì)造成覆蓋或多次備份。

需要注意

taosdump 內(nèi)部使用 TDengine stmt binding API 進(jìn)行恢復(fù)數(shù)據(jù)的寫(xiě)入，為提高數(shù)據(jù)恢復(fù)性能，目前使用 16384 為一次寫(xiě)入批次。如果備份數(shù)據(jù)中有較多列的數(shù)據(jù)，可能會(huì)導(dǎo)致產(chǎn)生 “WAL size exceeds limit” 錯(cuò)誤，此時(shí)可以通過(guò)使用 -B 參數(shù)調(diào)整為一個(gè)更小的值進(jìn)行嘗試。

寫(xiě)在最后

如果大家想要查閱 taosdump 詳細(xì)命令行參數(shù)列表，可以進(jìn)入 https://docs.taosdata.com/reference/taosdump/ 獲取。毫無(wú)疑問(wèn)，如果你掌握了上述 taosdump 使用指南，一定能幫助你較為完美地解決所遭遇的數(shù)據(jù)遷移問(wèn)題。但如果在應(yīng)用過(guò)程中出現(xiàn)了一些個(gè)性化難題，也無(wú)需心急，你可以進(jìn)入 TDengine 用戶交流群尋找?guī)椭?/p>