Skip to main content

使用安装包立即开始

您可以用 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 平台的安装包。

运行环境要求

在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 安装包。

  1. 从列表中下载获得 Deb 安装包;
    • 进入到安装包所在目录,执行如下的安装命令:

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

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

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

    note

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

    启动

    安装后,请使用 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
    info
    • 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 (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 命令行

    TDengine 图形化界面

    从 TDengine 3.3.0.0 开始,TDengine 发布包中增加了一个新的 web 组件:taos-explorer, 可以使用它进行数据库、超级表、子表、数据的查看和管理。其上也有一些只在企业版中才提供的高级特性,如需要可联系 TDengine 销售团队。

    使用 taos-explorer,需要从浏览器访问其映射在主机上的端口,假定主机名为 abc.com,映射到主机的端口为 6060,则需从浏览器访问 http://abc.com:6060. taos-explorer 默认在容器内使用 6060 端口。初次使用需要使用企业邮箱进行注册,注册后即可使用数据库中的用户名和密码登录

    使用 taosBenchmark 体验写入速度

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

    启动 TDengine 服务,然后在终端执行 taosBenchmark(曾命名为 taosdemo):

    $ taosBenchmark

    该命令将在数据库 test 下面自动创建一张超级表 meters,该超级表下有 1 万张表,表名为 d0d9999,每张表有 1 万条记录,每条记录有 tscurrentvoltagephase 四个字段,时间戳从 2017-07-14 10:40:00 000 到 2017-07-14 10:40:09 999,每张表带有标签 locationgroupId,groupId 被设置为 1 到 10,location 被设置为 California.CampbellCalifornia.CupertinoCalifornia.LosAngelesCalifornia.MountainViewCalifornia.PaloAltoCalifornia.SanDiegoCalifornia.SanFranciscoCalifornia.SanJoseCalifornia.SantaClara 或者 California.Sunnyvale

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

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

    使用 TDengine CLI 体验查询速度

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

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

    SELECT COUNT(*) FROM test.meters;

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

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

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

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

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

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

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

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

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