使用安装包快速体验 TDengine

TDengine 完整的软件包包括服务端（taosd）、应用驱动（taosc）、用于与第三方系统对接并提供 RESTful 接口的 taosAdapter、命令行程序（CLI，taos）和一些工具软件。目前 TDinsight 仅在 Linux 系统上安装和运行，后续将支持 Windows、macOS 等系统。TDengine 除了提供多种语言的连接器之外，还通过 taosAdapter 提供 RESTful 接口。

为方便使用，标准的服务端安装包包含了 taosd、taosAdapter、taosc、taos、taosdump、taosBenchmark、TDinsight 安装脚本和示例代码；如果您只需要用到服务端程序和客户端连接的 C/C++ 语言支持，也可以仅下载 Lite 版本的安装包。

在 Linux 系统上，TDengine 社区版提供 Deb 和 RPM 格式安装包，其中 Deb 支持 Debian/Ubuntu 及其衍生系统，RPM 支持 CentOS/RHEL/SUSE 及其衍生系统，用户可以根据自己的运行环境自行选择。同时我们也提供了 tar.gz 格式安装包，以及 apt-get 工具从线上进行安装。

此外，TDengine 也提供 macOS x64/m1 平台的 pkg 安装包。

运行环境要求

在linux系统中，运行环境最低要求如下:

linux 内核版本 - 3.10.0-1160.83.1.el7.x86_64;

glibc 版本 - 2.17;

如果通过clone源码进行编译安装，还需要满足:

cmake版本 - 3.26.4或以上;

gcc 版本 - 9.3.1或以上;

安装

注意

从TDengine 3.0.6.0 开始，不再提供单独的 taosTools 安装包，原 taosTools 安装包中包含的工具都在 TDengine-server 安装包中，如果需要请直接下载 TDengine -server 安装包。

Deb 安装

1. 从列表中下载获得 Deb 安装包；
   下载 TDengine

   

   输入您的电子邮箱以接收下载链接

   同意涛思数据通过此邮件地址联系我

   请勾选同意，便于我们通过邮件发送安装包给您。
2. 进入到安装包所在目录，执行如下的安装命令：

请将 <version> 替换为下载的安装包版本

sudo dpkg -i TDengine-server-<version>-Linux-x64.deb

RPM 安装

1. 从列表中下载获得 RPM 安装包；
   下载 TDengine

   

   输入您的电子邮箱以接收下载链接

   同意涛思数据通过此邮件地址联系我

   请勾选同意，便于我们通过邮件发送安装包给您。
2. 进入到安装包所在目录，执行如下的安装命令：

请将 <version> 替换为下载的安装包版本

sudo rpm -ivh TDengine-server-<version>-Linux-x64.rpm

tar.gz 安装

1. 从列表中下载获得 tar.gz 安装包；
   下载 TDengine

   

   输入您的电子邮箱以接收下载链接

   同意涛思数据通过此邮件地址联系我

   请勾选同意，便于我们通过邮件发送安装包给您。
2. 进入到安装包所在目录，使用 tar 解压安装包；
3. 进入到安装包所在目录，先解压文件后，进入子目录，执行其中的 install.sh 安装脚本。

请将 <version> 替换为下载的安装包版本

tar -zxvf TDengine-server-<version>-Linux-x64.tar.gz

解压文件后，进入相应子目录，执行其中的 install.sh 安装脚本：

sudo ./install.sh

信息

install.sh 安装脚本在执行过程中，会通过命令行交互界面询问一些配置信息。如果希望采取无交互安装方式，那么可以运行 ./install.sh -e no。运行 ./install.sh -h 指令可以查看所有参数的详细说明信息。

apt-get

可以使用 apt-get 工具从官方仓库安装。

配置包仓库

wget -qO - http://repos.taosdata.com/tdengine.key | sudo apt-key add -
echo "deb [arch=amd64] http://repos.taosdata.com/tdengine-stable stable main" | sudo tee /etc/apt/sources.list.d/tdengine-stable.list

如果安装 Beta 版需要安装包仓库：

wget -qO - http://repos.taosdata.com/tdengine.key | sudo apt-key add -
echo "deb [arch=amd64] http://repos.taosdata.com/tdengine-beta beta main" | sudo tee /etc/apt/sources.list.d/tdengine-beta.list

使用 apt-get 命令安装

sudo apt-get update
apt-cache policy tdengine
sudo apt-get install tdengine

提示

apt-get 方式只适用于 Debian 或 Ubuntu 系统。

Windows 安装

注意

• 目前 TDengine 在 Windows 平台上只支持 Windows Server 2016/2019 和 Windows 10/11。
• 从 TDengine 3.1.0.0 开始，只提供 Windows 客户端安装包。如果需要 Windows 服务端安装包，请联系 TDengine 销售团队升级为企业版。
• Windows 上需要安装 VC 运行时库，可在此下载安装 VC运行时库, 如果已经安装此运行库可忽略。

按照以下步骤安装：

1. 从列表中下载获得 exe 安装程序；
   下载 TDengine

   

   输入您的电子邮箱以接收下载链接

   同意涛思数据通过此邮件地址联系我

   请勾选同意，便于我们通过邮件发送安装包给您。
2. 运行可执行程序来安装 TDengine。 Note: 从 3.0.1.7 开始，只提供 TDengine 客户端的 Windows 客户端的下载。想要使用TDengine 服务端的 Windows 版本，请联系销售升级为企业版本。

macOS 安装

1. 从列表中下载获得 pkg 安装程序；
   下载 TDengine

   

   输入您的电子邮箱以接收下载链接

   同意涛思数据通过此邮件地址联系我

   请勾选同意，便于我们通过邮件发送安装包给您。
2. 运行可执行程序来安装 TDengine。如果安装被阻止，可以右键或者按 Ctrl 点击安装包，选择 打开。

信息

下载其他组件、最新 Beta 版及之前版本的安装包，请点击发布历史页面。

备注

当安装第一个节点时，出现 Enter FQDN: 提示的时候，不需要输入任何内容。只有当安装第二个或以后更多的节点时，才需要输入已有集群中任何一个可用节点的 FQDN，支持该新节点加入集群。当然也可以不输入，而是在新节点启动前，配置到新节点的配置文件中。

启动

Linux 系统

安装后，请使用 systemctl 命令来启动 TDengine 的服务进程。

systemctl start taosd
systemctl start taosadapter
systemctl start taoskeeper
systemctl start taos-explorer

你也可以直接运行 start-all.sh 脚本来启动上面的所有服务

start-all.sh 

可以使用 systemctl 来单独管理上面的每一个服务

systemctl start taosd
systemctl stop taosd
systemctl restart taosd
systemctl status taosd

信息

• systemctl 命令需要 root 权限来运行，如果您非 root 用户，请在命令前添加 sudo。
• systemctl stop taosd 指令在执行后并不会马上停止 TDengine 服务，而是会等待系统中必要的落盘工作正常完成。在数据量很大的情况下，这可能会消耗较长时间。
• 如果系统中不支持 systemd，也可以用手动运行 /usr/local/taos/bin/taosd 方式启动 TDengine 服务。

Windows 系统

安装后，可以在拥有管理员权限的 cmd 窗口执行 sc start taosd 或在 C:\TDengine 目录下，运行 taosd.exe 来启动 TDengine 服务进程。如需使用 http/REST 服务，请执行 sc start taosadapter 或运行 taosadapter.exe 来启动 taosAdapter 服务进程。

macOS 系统

安装后，在应用程序目录下，双击 TDengine 图标来启动程序，也可以运行 sudo launchctl start 来启动 TDengine 服务进程。

sudo launchctl start com.tdengine.taosd
sudo launchctl start com.tdengine.taosadapter
sudo launchctl start com.tdengine.taoskeeper
sudo launchctl start com.tdengine.taos-explorer

你也可以直接运行 start-all.sh 脚本来启动上面的所有服务

start-all.sh

可以使用 launchctl 命令管理上面提到的每个 TDengine 服务，以下示例使用 taosd ：

sudo launchctl start com.tdengine.taosd
sudo launchctl stop com.tdengine.taosd
sudo launchctl list | grep taosd
sudo launchctl print system/com.tdengine.taosd

信息

• launchctl 命令管理com.tdengine.taosd需要管理员权限，务必在前面加 sudo 来增强安全性。
• sudo launchctl list | grep taosd 指令返回的第一列是 taosd 程序的 PID，若为 - 则说明 TDengine 服务未运行。
• 故障排查：
• 如果服务异常请查看系统日志 launchd.log 或者 /var/log/taos 目录下 taosdlog 日志获取更多信息。

TDengine 命令行（CLI）

为便于检查 TDengine 的状态，执行数据库（Database）的各种即席（Ad Hoc）查询，TDengine 提供一命令行应用程序（以下简称为 TDengine CLI）taos。要进入 TDengine 命令行，您只要在终端执行 taos (Linux/Mac) 或 taos.exe (Windows) 即可。 TDengine CLI 的提示符号如下：

taos>

在 TDengine CLI 中，用户可以通过 SQL 命令来创建/删除数据库、表等，并进行数据库（Database）插入查询操作。在终端中运行的 SQL 语句需要以分号（;）结束来运行。示例：

CREATE DATABASE demo;
USE demo;
CREATE TABLE t (ts TIMESTAMP, speed INT);
INSERT INTO t VALUES ('2019-07-15 00:00:00', 10);
INSERT INTO t VALUES ('2019-07-15 01:00:00', 20);
SELECT * FROM t;

           ts            |    speed    |
========================================
 2019-07-15 00:00:00.000 |          10 |
 2019-07-15 01:00:00.000 |          20 |

Query OK, 2 row(s) in set (0.003128s)

除执行 SQL 语句外，系统管理员还可以从 TDengine CLI 进行检查系统运行状态、添加删除用户账号等操作。TDengine CLI 连同应用驱动也可以独立安装在机器上运行，更多细节请参考 TDengine 命令行。

快速体验

体验写入

taosBenchmark 是一个专为测试 TDengine 性能而设计的工具，它能够全面评估TDengine 在写入、查询和订阅等方面的功能表现。该工具能够模拟大量设备产生的数据，并允许用户灵活控制数据库、超级表、标签列的数量和类型、数据列的数量和类型、子表数量、每张子表的数据量、写入数据的时间间隔、工作线程数量以及是否写入乱序数据等策略。

启动 TDengine 的服务，在终端中执行如下命令

taosBenchmark -y

系统将自动在数据库 test 下创建一张名为 meters的超级表。这张超级表将包含 10,000 张子表，表名从 d0 到 d9999，每张表包含 10,000条记录。每条记录包含 ts（时间戳）、current（电流）、voltage（电压）和 phase（相位）4个字段。时间戳范围从 “2017-07-14 10:40:00 000” 到 “2017-07-14 10:40:09 999”。每张表还带有 location 和 groupId 两个标签，其中，groupId 设置为 1 到 10，而 location 则设置为 California.Campbell、California.Cupertino 等城市信息。

执行该命令后，系统将迅速完成 1 亿条记录的写入过程。实际所需时间取决于硬件性能，但即便在普通 PC 服务器上，这个过程通常也只需要十几秒。

taosBenchmark 提供了丰富的选项，允许用户自定义测试参数，如表的数目、记录条数等。要查看详细的参数列表，请在终端中输入如下命令

taosBenchmark --help

有关taosBenchmark 的详细使用方法，请参考taosBenchmark 参考手册

体验查询

使用上述 taosBenchmark 插入数据后，可以在 TDengine CLI（taos）输入查询命令，体验查询速度。

1. 查询超级表 meters 下的记录总条数

SELECT COUNT(*) FROM test.meters;

2. 查询 1 亿条记录的平均值、最大值、最小值

SELECT AVG(current), MAX(voltage), MIN(phase) FROM test.meters;

3. 查询 location = "California.SanFrancisco" 的记录总条数

SELECT COUNT(*) FROM test.meters WHERE location = "California.SanFrancisco";

4. 查询 groupId = 10 的所有记录的平均值、最大值、最小值

SELECT AVG(current), MAX(voltage), MIN(phase) FROM test.meters WHERE groupId = 10;

5. 对表 d1001 按每 10 秒进行平均值、最大值和最小值聚合统计

SELECT _wstart, AVG(current), MAX(voltage), MIN(phase) FROM test.d1001 INTERVAL(10s);

在上面的查询中，使用系统提供的伪列 _wstart 来给出每个窗口的开始时间。