跳到主要内容

TDengine 快速上手

前面 TDengine 安装 介绍了 3 种安装 TDengine 的方式。安装成功后,我们就可以使用 TDengine 时序数据库了,本文主要介绍 TDengine 服务端和客户端程序的使用,并通过一个简单的案例来体验 TDengine 的基本功能。

启动服务器

在 Linux 系统中,我们可使用 systemctl 命令来启动 TDengine 的服务进程。

首先查看一下 TDengine 服务的状态:

sudo systemctl status taosd

如果服务未启动,可以执行下面命令启动:

sudo systemctl start taosd

TDengine 服务的配置文件是 /etc/taos/taos.cfg,我们可以修改其中的配置参数来调整 TDengine 的运行。例如,telemetryReporting 参数为 1,表示允许 TDengine 采集用户的基本使用信息,以改善产品。我们可以将其设为 0,关闭该功能。

# enable/disable installation / usage report
telemetryReporting 0

修改后重启 TDengine 服务:

sudo systemctl restart taosd

如果需要停止 TDengine 服务,则执行:

sudo systemctl stop taosd

不过需要注意的是,执行该命令后并不会马上停止 TDengine 服务,而是会等待系统中必要的落盘工作正常完成。所以在数据量很大的情况下,这条命令可能会消耗较长时间。

另外,如果想在一些没有 systemd 服务的 Linux 系统上运行 TDengine,可以直接手动启动 taosd 服务程序。例如:

/usr/local/taos/bin/taosd

客户端登录

启动 TDengine 服务器后,接下来就可以使用 taos 客户端登录。taos 是一个命令行工具,语法如下:

taos [OPTION...]

它提供了一些选项参数,启动时添加特定的选项和参数来改变 TDengine 客户端的行为。常用的一下选项有:

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

如果需要登录本地的 TDengine 服务器,直接执行 taos 即可。

taos

如果 TDengine 终端连接服务成功,将会打印出欢迎消息和版本信息。如果失败,则会打印错误消息出来。

$ taos

Welcome to the TDengine shell from Linux, Client Version:2.2.2.0
Copyright (c) 2020 by TAOS Data, Inc. All rights reserved.

taos>

使用示例

因为 TDengine 支持标准 SQL 语法,所以登录 TDengine 终端后,我们就可以通过 SQL 命令来创建或删除数据库、表等,并进行插入、查询等操作。

注意:在 TDengine 终端中运行的 SQL 语句需要以分号(;)结束。

创建一个名为 db 的数据库:

create database db;

选择使用 db 数据库:

use db;

在 db 数据库中创建数据表 t:

create table t (ts timestamp, speed int);

往数据表 t 中插入两条数据:

insert into t values ('2021-12-01 00:00:00', 10);
insert into t values ('2021-12-01 01:00:00', 20);

查询数据表 t 的所有内容:

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)

是不是和 MySQL 的操作一样?当然啦,除执行 SQL 语句外,系统管理员也可以从 TDengine 终端检查系统运行状态,添加删除用户账号等。