> 小 T 導讀：為了讓大家更好地進行 [TDengine]( https://www.taosdata.com/"TDengine") 叢集間的備份和遷移工作，一款名為 taosdump 的工具應用程式被打造出來。在本篇文章中，我們對 taosdump 的使用方法和注意事項進行了相關彙總，給到有需要的開發者。

作為 TDengine 的一款工具應用程式，taosdump 支援從執行中的 TDengine 叢集備份資料，並將備份的資料恢復到相同或另一個執行中的 TDengine 叢集中，其使用 Apache AVRO（https://avro.apache.org/） 作為資料檔案格式來儲存備份資料。

值得一提的是，taosdump 可以用 Database、超級表或普通表作為邏輯資料單元進行備份，也可以對 Database、超級表和普通表中指定時間段內的資料記錄進行備份。在使用時，我們可以對 taosdump 指定資料備份的目錄路徑；如果不指定位置，它就會預設將資料備份到當前目錄；如果指定的位置已經有資料檔案，taosdump 會提示使用者並立即退出，避免資料被覆蓋。這意味著同一路徑只能被用於一次備份。如果大家看到相關提示，務必小心操作。

但需要注意的是，taosdump 是一個邏輯備份工具，它不應被用於備份任何原始資料、環境設定、 硬體資訊、服務端配置或叢集的拓撲結構。

**安裝**

taosdump 有以下兩種安裝方式：
安裝 taosTools 官方安裝包，你可以進入 https://www.taosdata.com/all-downloads 此頁面找到 taosTools 並進行下載安裝。
單獨編譯 taosTools 並安裝，詳情請參考 taos-tools 倉庫（https://github.com/taosdata/taos-tools）。

**常用使用場景**

**taosdump 備份資料**
- 備份所有資料庫：指定 -A 或 --all-databases 引數；
- 備份多個指定資料庫：使用 -D db1,db2,... 引數；
- 備份指定資料庫中的某些超級表或普通表：使用 dbname stbname1 stbname2 tbname1 tbname2 ... 引數，注意這種輸入序列第一個引數為資料庫名稱，且只支援一個資料庫，第二個和之後的引數為該資料庫中的超級表或普通表名稱，中間以空格分隔；
- 備份系統 log 庫：TDengine 叢集通常會包含一個系統資料庫，名為 log，這個資料庫內的資料為 TDengine 自我執行的資料，taosdump 預設不會對 log 庫進行備份。如果有特定需求對 log 庫進行備份，可以使用 -a 或 --allow-sys 命令列引數。
- “寬容”模式備份：taosdump 1.4.1 之後的版本提供 -n 引數和 -L 引數，用於備份資料時不使用跳脫字元和“寬容”模式，可以在表名、列名、標籤名沒使用跳脫字元的情況下減少備份資料時間和備份資料佔用空間。如果不確定是否符合使用 -n 和 -L 條件時，請使用預設引數進行“嚴格”模式進行備份。跳脫字元的說明請參考官方文件（https://docs.taosdata.com/taos-sql/escape/）。

**需要注意**
- taosdump 1.4.1 之後的版本提供 -I 引數，用於解析 avro 檔案 schema 和資料，如果指定 -s 引數將只解析 schema。
- taosdump 1.4.2 之後的備份使用 -B 引數指定的批次數，預設值為 16384，如果在某些環境下由於網路速度或磁碟效能不足導致 “Error actual dump .. batch ..” ，可以透過 -B 引數調整為更小的值進行嘗試。
- taosdump 的匯出不支援中斷恢復，所以當程式意外終止後，正確的處理方式是刪除當前已匯出或生成的所有相關檔案。
- taosdump 的匯入支援中斷恢復，但是當程式重新啟動時，會收到一些“表已經存在”的提示，可以忽視。

**taosdump 恢復資料**

如果我們想要恢復指定路徑下的資料檔案，方式是：使用 -i 引數加上資料檔案所在路徑。如前文提及，我們不能使用同一個目錄備份不同資料集合，也不能在同一路徑多次備份同一資料集，否則備份資料會造成覆蓋或多次備份。

**需要注意**
taosdump 內部使用 TDengine stmt binding API 進行恢復資料的寫入，為提高資料恢復效能，目前使用 16384 為一次寫入批次。如果備份資料中有較多列的資料，可能會導致產生 “WAL size exceeds limit” 錯誤，此時可以透過使用 -B 引數調整為一個更小的值進行嘗試。

**寫在最後**

如果大家想要查閱 taosdump 詳細命令列引數列表，可以進入 https://docs.taosdata.com/reference/taosdump/ 獲取。毫無疑問，如果你掌握了上述 taosdump 使用指南，一定能幫助你較為完美地解決所遭遇的資料遷移問題。但如果在應用過程中出現了一些個性化難題，也無需心急，你可以進入 TDengine 使用者交流群尋找幫助。

**歡迎新增小T（VX：TDengine），加入物聯網技術討論群，第一時間瞭解TDengine 官方資訊，與關注前沿技術的同學們共同探討新技術、新玩法。**

------------

想了解更多 TDengine Database的具體細節，歡迎大家在[GitHub]( https://github.com/taosdata/grafanaplugin"GitHub")上檢視相關原始碼。
[![](http://img.blog.itpub.net/blog/2022/05/11/0fd59db1207fc97f.jpeg?x-oss-process=style/bb)](https://www.taosdata.com/?zh "![](http://img.blog.itpub.net/blog/2022/05/11/0fd59db1207fc97f.jpeg?x-oss-process=style/bb)")

TDengine | taosdump 的使用方法和注意事項

相關文章