使用安装包立即开始

您可以用 Docker 立即体验 TDengine。如果您希望对 TDengine 贡献代码或对内部实现感兴趣，请参考我们的 TDengine GitHub 主页 下载源码构建和安装.

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 工具从线上进行安装。需要注意的是，RPM 和 Deb 包不含 taosdump 和 TDinsight 安装脚本，这些工具需要通过安装 taosTools 包获得。TDengine 也提供 Windows x64 平台和 macOS x64/m1 平台的安装包。

安装

  • Deb 安装
  • RPM 安装
  • tar.gz 安装
  • apt-get
  • Windows 安装
  • macOS 安装

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

    下载 TDengine

    TDengine Database

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

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

    请勾选同意，便于我 们通过邮件发送安装包给您。

    下载

    关闭

  2. 进入到安装包所在目录，执行如下的安装命令：

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

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

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

    下载 TDengine

    TDengine Database

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

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

    请勾选同意，便于我 们通过邮件发送安装包给您。

    下载

    关闭

  2. 进入到安装包所在目录，执行如下的安装命令：

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

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

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

    下载 TDengine

    TDengine Database

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

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

    请勾选同意，便于我 们通过邮件发送安装包给您。

    下载

    关闭

  2. 进入到安装包所在目录，使用 tar 解压安装包；

  3. 进入到安装包所在目录，先解压文件后，进入子目录，执行其中的 install.sh 安装脚本。

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

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

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

  1. sudo ./install.sh
安装包 - 图4info

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

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

配置包仓库

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

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

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

使用 apt-get 命令安装

  1. sudo apt-get update
  2. apt-cache policy tdengine
  3. sudo apt-get install tdengine
安装包 - 图5tip

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

注意：目前 TDengine 在 Windows 平台上只支持 Windows Server 2016/2019 和 Windows 10/11。

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

    下载 TDengine

    TDengine Database

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

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

    请勾选同意，便于我 们通过邮件发送安装包给您。

    下载

    关闭

  2. 运行可执行程序来安装 TDengine。

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

    下载 TDengine

    TDengine Database

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

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

    请勾选同意，便于我 们通过邮件发送安装包给您。

    下载

    关闭

  4. 运行可执行程序来安装 TDengine。如果安装被阻止，可以右键或者按 Ctrl 点击安装包，选择 打开。

安装包 - 图8info

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

安装包 - 图9note

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

启动

  • Linux 系统
  • Windows 系统
  • macOS 系统

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

  1. systemctl start taosd

检查服务是否正常工作：

  1. systemctl status taosd

如果服务进程处于活动状态，则 status 指令会显示如下的相关信息：

  1. Active: active (running)

如果后台服务进程处于停止状态，则 status 指令会显示如下的相关信息：

  1. Active: inactive (dead)

如果 TDengine 服务正常工作，那么您可以通过 TDengine 的命令行程序 taos 来访问并体验 TDengine。

如下 systemctl 命令可以帮助你管理 TDengine 服务：

  • 启动服务进程：systemctl start taosd

  • 停止服务进程：systemctl stop taosd

  • 重启服务进程：systemctl restart taosd

  • 查看服务状态：systemctl status taosd

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

TDengine 命令行（CLI）

为便于检查 TDengine 的状态，执行数据库（Database）的各种即席（Ad Hoc）查询，TDengine 提供一命令行应用程序（以下简称为 TDengine CLI）taos。要进入 TDengine 命令行，您只要在终端执行 taos 即可。

安装后，在 C:\TDengine 目录下，运行 taosd.exe 来启动 TDengine 服务进程。

TDengine 命令行（CLI）

为便于检查 TDengine 的状态，执行数据库（Database）的各种即席（Ad Hoc）查询，TDengine 提供一命令行应用程序（以下简称为 TDengine CLI）taos。要进入 TDengine 命令行，您只要在终端执行 taos 即可。

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

如下 launchctl 命令用于管理 TDengine 服务：

  • 启动服务进程：sudo launchctl start com.tdengine.taosd

  • 停止服务进程：sudo launchctl stop com.tdengine.taosd

  • 查看服务状态：sudo launchctl list | grep taosd

安装包 - 图11info
  • 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 命令行，您只要在 Windows 终端的 C:\TDengine 目录下，运行 taos.exe 来启动 TDengine 命令行。

  1. taos

如果连接服务成功，将会打印出欢迎消息和版本信息。如果失败，则会打印错误消息出来（请参考 FAQ 来解决终端连接服务端失败的问题）。TDengine CLI 的提示符号如下：

  1. taos>

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

  1. CREATE DATABASE demo;
  2. USE demo;
  3. CREATE TABLE t (ts TIMESTAMP, speed INT);
  4. INSERT INTO t VALUES ('2019-07-15 00:00:00', 10);
  5. INSERT INTO t VALUES ('2019-07-15 01:00:00', 20);
  6. SELECT * FROM t;
  8.            ts            |    speed    |
  9. ========================================
  10.  2019-07-15 00:00:00.000 |          10 |
  11.  2019-07-15 01:00:00.000 |          20 |
  13. Query OK, 2 row(s) in set (0.003128s)

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

使用 taosBenchmark 体验写入速度

可以使用 TDengine 的自带工具 taosBenchmark 快速体验 TDengine 的写入速度。

启动 TDengine 服务，然后在终端执行 taosBenchmark（曾命名为 taosdemo）：

  1. $ taosBenchmark

该命令将在数据库 test 下面自动创建一张超级表 meters，该超级表下有 1 万张表，表名为 d0 到 d9999，每张表有 1 万条记录，每条记录有 ts、current、voltage、phase 四个字段，时间戳从 2017-07-14 10:40:00 000 到 2017-07-14 10:40:09 999，每张表带有标签 location 和 groupId，groupId 被设置为 1 到 10，location 被设置为 California.Campbell、California.Cupertino、California.LosAngeles、California.MountainView、California.PaloAlto、California.SanDiego、California.SanFrancisco、California.SanJose、California.SantaClara 或者 California.Sunnyvale。

这条命令很快完成 1 亿条记录的插入。具体时间取决于硬件性能，即使在一台普通的 PC 服务器往往也仅需十几秒。

taosBenchmark 命令本身带有很多选项，配置表的数目、记录条数等等，您可以设置不同参数进行体验，请执行 taosBenchmark --help 详细列出。taosBenchmark 详细使用方法请参照如何使用 taosBenchmark 对 TDengine 进行性能测试和 taosBenchmark 参考手册。

使用 TDengine CLI 体验查询速度

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

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

  1. SELECT COUNT(*) FROM test.meters;

查询 1 亿条记录的平均值、最大值、最小值等：

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

查询 location = “California.SanFrancisco” 的记录总条数：

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

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

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

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

  1. SELECT FIRST(ts), AVG(current), MAX(voltage), MIN(phase) FROM test.d10 INTERVAL(10s);

在上面的查询中，你选择的是区间内的第一个时间戳（ts），另一种选择方式是 \_wstart，它将给出时间窗口的开始。关于窗口查询的更多信息，参见特色查询。