TDengine：taosBenchmark的使用方式

小 T 导读：用户在做数据库>时序数据库（Time Series Database，TSDB）的选型调研时，通常要进行环境模拟测试，以观察所选数据库的性能优劣和成本损耗情况。为方便用户，TDengine 官方提供了一款名为 taosBenchmark 的测试工具，本文将会详细讲解其使用方式，供读者参考。

taosBenchmark （曾用名 taosdemo ) 是一个用于测试 TDengine 产品性能的工具。taosBenchmark 可以测试 TDengine 的插入、查询和订阅等功能的性能，它可以模拟由大量设备产生的大量数据，还可以灵活地控制数据库、超级表、标签列的数量和类型，数据列的数量和类型，子表的数量，每张子表的数据量，插入数据的时间间隔，taosBenchmark 的工作线程数量，是否以及如何插入乱序数据等。为了兼容过往用户的使用习惯，TDengine 安装包提供了 taosdemo 作为 taosBenchmark 的软链接。

安装

taosBenchmark 有两种安装方式:

安装 TDengine 官方安装包的同时会自动安装 taosBenchmark，详情请参考 TDengine 安装（安装和卸载 | TDengine 文档 | 涛思数据）。
单独编译 taos-tools 并安装，详情请参考 taos-tools 仓库（GitHub - taosdata/taos-tools: taos-tools are some useful tool collections for TDengine.）。

运行

配置和运行方式

taosBenchmark 需要在操作系统的终端执行，该工具支持两种配置方式：命令行参数和 JSON 配置文件。但这两种方式是互斥的，在使用配置文件时只能使用一个命令行参数 -f <json file> 指定配置文件；在使用命令行参数运行 taosBenchmark 并控制其行为时则不能使用 -f 参数而要用其它参数来配置。除此之外，taosBenchmark 还提供了一种特殊的运行方式，即无参数运行。

taosBenchmark 支持对 TDengine 做完备的性能测试，其所支持的 TDengine 功能分为三大类：写入、查询和订阅。这三种功能之间是互斥的，每次运行 taosBenchmark 只能选择其中之一。值得注意的是，所要测试的功能类型在使用命令行配置方式时是不可配置的，命令行配置方式只能测试写入性能。若要测试 TDengine 的查询和订阅性能，必须使用配置文件的方式，通过配置文件中的参数 filetype 指定所要测试的功能类型。

具体的命令行参数和 JSON 配置文件，可移步至 taosBenchmark | TDengine 文档 | 涛思数据进行查阅。但需要注意的是，在运行 taosBenchmark 之前一定要确保 TDengine 集群已经在正确运行。

无命令行参数运行

执行下列命令即可快速体验 taosBenchmark 对 TDengine 进行基于默认配置的写入性能测试。

taosBenchmark

在无参数运行时，taosBenchmark 默认连接 /etc/taos 下指定的 TDengine 集群，并在 TDengine 中创建一个名为 test 的数据库，test 数据库下创建名为 meters 的一张超级表，超级表下创建 10000 张表，每张表中写入 10000 条记录。注意，如果已有 test 数据库，这个命令会先删除该数据库后建立一个全新的 test 数据库。