小 T 導讀：使用者在做[時序資料庫]( https://www.taosdata.com/"時序資料庫")（Time Series Database，TSDB）的選型調研時，通常要進行環境模擬測試，以觀察所選資料庫的效能優劣和成本損耗情況。為方便使用者，[TDengine]( https://www.taosdata.com/"TDengine") 官方提供了一款名為 taosBenchmark 的測試工具，本文將會詳細講解其使用方式，供讀者參考。

taosBenchmark （曾用名 taosdemo ) 是一個用於測試 TDengine 產品效能的工具。taosBenchmark 可以測試 TDengine 的插入、查詢和訂閱等功能的效能，它可以模擬由大量裝置產生的大量資料，還可以靈活地控制資料庫、超級表、標籤列的數量和型別，資料列的數量和型別，子表的數量，每張子表的資料量，插入資料的時間間隔，taosBenchmark 的工作執行緒數量，是否以及如何插入亂序資料等。為了相容過往使用者的使用習慣，TDengine 安裝包提供 了 taosdemo 作為 taosBenchmark 的軟連結。

**安裝**

taosBenchmark 有兩種安裝方式:
安裝 TDengine 官方安裝包的同時會自動安裝 taosBenchmark，詳情請參考 TDengine 安裝（https://docs.taosdata.com/operation/pkg-install/）。
單獨編譯 taos-tools 並安裝，詳情請參考 taos-tools 倉庫（https://github.com/taosdata/taos-tools）。

**執行**

**配置和執行方式**
taosBenchmark 需要在作業系統的終端執行，該工具支援兩種配置方式：命令列引數和 JSON 配置檔案。但這兩種方式是互斥的，在使用配置檔案時只能使用一個命令列引數 -f <json file=""> 指定配置檔案；在使用命令列引數執行 taosBenchmark 並控制其行為時則不能使用 -f 引數而要用其它引數來配置。除此之外，taosBenchmark 還提供了一種特殊的執行方式，即無引數執行。

taosBenchmark 支援對 TDengine 做完備的效能測試，其所支援的 TDengine 功能分為三大類：寫入、查詢和訂閱。這三種功能之間是互斥的，每次執行 taosBenchmark 只能選擇其中之一。值得注意的是，所要測試的功能型別在使用命令列配置方式時是不可配置的，命令列配置方式只能測試寫入效能。若要測試 TDengine 的查詢和訂閱效能，必須使用配置檔案的方式，透過配置檔案中的引數 filetype 指定所要測試的功能型別。

具體的命令列引數和 JSON 配置檔案，可移步至 https://docs.taosdata.com/reference/taosbenchmark/ 進行查閱。但需要注意的是，在執行 taosBenchmark 之前一定要確保 TDengine 叢集已經在正確執行。

**無命令列引數執行**
執行下列命令即可快速體驗 taosBenchmark 對 TDengine 進行基於預設配置的寫入效能測試。
`taosBenchmark`

在無引數執行時，taosBenchmark 預設連線 /etc/taos 下指定的 TDengine 叢集，並在 TDengine 中建立一個名為 test 的資料庫，test 資料庫下建立名為 meters 的一張超級表，超級表下建立 10000 張表，每張表中寫入 10000 條記錄。注意，如果已有 test 資料庫，這個命令會先刪除該資料庫後建立一個全新的 test 資料庫。

**使用命令列配置引數執行**
在使用命令列引數執行 taosBenchmark 並控制其行為時，-f <json file=""> 引數不能使用。所有配置引數都必須透過命令列指定。以下是使用命令列方式測試 taosBenchmark 寫入效能的一個示例。
`taosBenchmark -I stmt -n 200 -t 100`

在上面的命令中， taosBenchmark 將建立一個名為test的資料庫，在其中建立一張超級表meters，在該超級表中建立 100 張子表並使用引數繫結的方式為每張子表插入 200 條記錄。

**使用配置檔案執行**
taosBenchmark 安裝包中提供了配置檔案的示例，位於<install_directory>/examples/taosbenchmark-json 下，使用如下命令列即可執行 taosBenchmark 並透過配置檔案控制其行為。
`taosBenchmark -f <json file="">`

更多配置相關內容，參考 https://docs.taosdata.com/reference/taosbenchmark/ 。如在實踐中遇到更多實際問題，聯絡小 T 進入指定的 TDengine 官方使用者群，專業的社群技術人員會幫助你答疑解惑，理順思路。

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

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

想了解更多 [TDengine Database]( https://www.taosdata.com/?zh"TDengine Database")的具體細節，歡迎大家在[GitHub]( https://github.com/taosdata/TDengine"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)")</json></install_directory></json></json>

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

相關文章