立即开始

快捷安装

TDengine软件分为服务器、客户端和报警模块三部分,目前2.0版服务器仅能在Linux系统上安装和运行,后续会支持Windows、Mac OS等系统。客户端可以在Windows或Linux上安装和运行。任何OS的应用也可以选择RESTful接口连接服务器taosd。CPU支持X64/ARM64/MIPS64/Alpha64,后续会支持ARM32、RISC-V等CPU架构。 您可根据需求选择通过源码或者安装包来安装。

  • 查看完整的Release notes,请点击这里
  • 下载其他组件、最新beta版及之前版本的安装包,请点击这里

具体的安装过程,请参见TDengine多种安装包的安装和卸载 以及视频教程

通过源码安装

请参考我们的TDengine github主页下载源码并安装.

通过Docker容器运行

暂时不推荐生产环境在 Docker 内部署 TDengine 的客户端或服务端,但在开发环境下或初次尝试时,使用 Docker 方式部署是十分方便的。特别是,利用 Docker,可以方便地在 Mac OSX 和 Windows 环境下尝试 TDengine。

直接运行:docker run tdengine/tdengine 即可

更详细的步骤说明,请参考通过Docker快速体验TDengine

通过安装包安装

TDengine 的安装非常简单,从下载到安装成功仅仅只要几秒钟。为方便使用,标准的服务端安装包包含了客户端程序、各种编程语言的连接器和示例代码;如果您只需要用到服务端程序和客户端连接的 C/C++ 语言支持,那么也可以仅下载 lite 版本的安装包。在安装包格式上,我们提供 rpm、deb、tar.gz 三种,以方便在特定操作系统上使用,您可以根据需要选择下载:

客户端

如果客户端和服务端运行在不同的电脑上,可以单独安装客户端。Linux 和 Windows 安装包如下(其中 lite 版本的安装包仅带有 C/C++ 语言的连接支持,而标准版本的安装包还包含 Java、Python、Go、Node.js 等编程语言的连接器支持和示例代码):

轻松启动

安装成功后,用户可使用systemctl命令来启动TDengine的服务进程。

systemctl start taosd

检查服务是否正常工作。

systemctl status taosd

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

注意:

  • systemctl 命令需要 root 权限来运行,如果您非 root 用户,请在命令前添加 sudo
  • 为更好的获得产品反馈,改善产品,TDengine会采集基本的使用信息,但您可以修改系统配置文件taos.cfg里的配置参数telemetryReporting,将其设为0,就可将其关闭。
  • TDengine采用FQDN(一般就是hostname)作为节点的ID,为保证正常运行,需要给运行taosd的服务器配置好hostname, 在客户端应用运行的机器配置好DNS服务或hosts文件,保证FQDN能够解析。
  • systemctl stop taosd 指令在执行后并不会马上停止 TDengine 服务,而是会等待系统中必要的落盘工作正常完成。在数据量很大的情况下,这可能会消耗较长时间。
  • TDengine 支持在使用systemd做进程服务管理的linux系统上安装,用which systemctl命令来检测系统中是否存在systemd包:
    which systemctl

    如果系统中不支持systemd,也可以用手动运行 /usr/local/taos/bin/taosd 方式启动 TDengine 服务。

TDengine命令行程序

执行TDengine命令行程序,您只要在Linux终端执行taos即可

taos

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

taos>

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

create database db;
use db;
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终端检查系统运行状态,添加删除用户账号等。

命令行参数

您可通过配置命令行参数来改变TDengine终端的行为。以下为常用的几个命令行参数:

  • -c, --config-dir: 指定配置文件目录,默认为/etc/taos
  • -h, --host: 指定服务的FQDN,默认为本地服务
  • -s, --commands: 在不进入终端的情况下运行TDengine命令
  • -u, --user: 连接TDengine服务器的用户名,缺省为root
  • -p, --password: 连接TDengine服务器的密码,缺省为taosdata
  • -?, --help: 打印出所有命令行参数

示例:

taos -h 192.168.0.1 -s "use db; show tables;"

运行SQL命令脚本

TDengine终端可以通过source命令来运行SQL命令脚本.

taos> source <filename>;

Shell小技巧

  • 可以使用上下光标键查看历史输入的指令
  • 修改用户密码,在shell中使用alter user指令
  • ctrl+c 中止正在进行中的查询
  • 执行RESET QUERY CACHE清空本地缓存的表的schema

注意:如果从不同于taosd运行的机器运行taos, 请注意该机器的DNS或hosts文件的配置,该机器需要能正确解析服务器的hostname, 否则taos无法正常工作。

TDengine 极速体验

启动TDengine的服务,在Linux终端执行taosdemo

> taosdemo

该命令将在数据库 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 和 groupdId,groupdId 被设置为 1 到 10, location 被设置为 "beijing" 或者 "shanghai"。

执行这条命令大概需要几分钟,最后共插入 1 亿条记录。

在TDengine客户端输入查询命令,体验查询速度。

  • 查询超级表下记录总条数:
taos> select count(*) from test.meters;
  • 查询1亿条记录的平均值、最大值、最小值等:
taos> select avg(current), max(voltage), min(phase) from test.meters;
  • 查询location="beijing"的记录总条数:
taos> select count(*) from test.meters where location="beijing";
  • 查询groupdId=10的所有记录的平均值、最大值、最小值等:
taos> select avg(current), max(voltage), min(phase) from test.meters where groupdId=10;
  • 对表d10按10s进行平均值、最大值和最小值聚合统计:
taos> select avg(current), max(voltage), min(phase) from test.d10 interval(10s);

Note: taosdemo命令本身带有很多选项,配置表的数目、记录条数等等,请执行 taosdemo --help详细列出。您可以设置不同参数进行体验。

支持平台列表

TDengine服务器支持的平台列表

CentOS 6/7/8Ubuntu 16/18/20Other Linux统信 UOS银河/中标麒麟凝思 V60/V80华为 EulerOS
X64
龙芯 MIPS64
鲲鹏 ARM64
申威 Alpha64
飞腾 ARM64○优麒麟
海光 X64
瑞芯微 ARM64
全志 ARM64
炬力 ARM64
华为云 ARM64

注: ● 表示经过官方测试验证, ○ 表示非官方测试验证。


TDengine客户端和连接器支持的平台列表

目前TDengine的连接器可支持的平台广泛,目前包括:X64/X86/ARM64/ARM32/MIPS/Alpha等硬件平台,以及Linux/Win64/Win32等开发环境。

对照矩阵如下:

CPUX64 64bitX86 32bitARM64ARM32MIPS 龙芯Alpha 申威X64 海光
OSLinuxWin64Win32Win32LinuxLinuxLinuxLinuxLinux
C/C++
JDBC
Python
Go
NodeJS
C#
RESTful

其中 ● 表示经过官方测试验证, ○ 表示非官方测试验证。

请跳转到 连接器 查看更详细的信息。