TDengine 快速上手：数据写入与查询体验指南

TDengine 快速上手：数据写入与查询体验指南

TDengine TDengine is an open source, high-performance, cloud native time-series database optimized for Internet of Things (IoT), Connected Cars, Industrial IoT and DevOps. 项目地址: https://gitcode.com/gh_mirrors/tde/TDengine

前言

TDengine 是一款专为物联网、工业互联网等场景设计的高性能时序数据库。本文将带您快速体验 TDengine 的核心功能——高效的数据写入和查询能力。通过实际操作，您将直观感受 TDengine 在处理海量时序数据时的卓越性能。

数据写入体验

使用 taosBenchmark 工具

TDengine 提供了专门的性能测试工具 taosBenchmark，它不仅能测试性能，也是快速生成测试数据的好帮手。这个工具可以模拟真实场景中的设备数据生成，具有以下特点：

1. 支持自定义数据库、超级表结构
2. 可灵活配置标签列和数据列
3. 支持多线程写入
4. 可模拟乱序数据写入

快速生成测试数据

执行以下命令即可快速生成测试数据：

taosBenchmark -y

这个命令会自动完成以下操作：

1. 创建名为 test 的数据库
2. 在该库下创建名为 meters 的超级表
3. 生成 10,000 张子表（d0 到 d9999）
4. 每张子表写入 10,000 条记录（总计 1 亿条）

生成的每条记录包含以下字段：

• ts：时间戳（2017-07-14 10:40:00 000 到 2017-07-14 10:40:09 999）
• current：电流值
• voltage：电压值
• phase：相位值

每张子表还带有两个标签字段：

• location：地理位置（如 California.Campbell）
• groupId：分组ID（1-10）

性能表现

在普通 PC 服务器上，写入 1 亿条记录通常仅需十几秒。实际性能取决于硬件配置，您可以通过调整参数来测试不同场景下的表现。

自定义测试参数

taosBenchmark 提供了丰富的配置选项：

taosBenchmark --help

常用参数包括：

• -T/--threads：工作线程数
• -t/--tables：子表数量
• -n/--records：每表记录数
• -i/--insert-interval：写入间隔

数据查询体验

写入数据后，我们可以通过 TDengine CLI (taos) 体验其强大的查询能力。

基础统计查询

1. 查询总记录数（1亿条）

SELECT COUNT(*) FROM test.meters;

2. 查询全局统计值

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

条件查询

1. 按地理位置查询

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

2. 按分组查询统计值

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

时间窗口聚合

TDengine 特别擅长时间序列数据的窗口计算：

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

这里使用了 _wstart 伪列表示窗口开始时间，INTERVAL(10s) 指定了 10 秒为一个时间窗口。

性能特点解析

通过上述体验，您应该已经感受到 TDengine 的几个显著特点：

1. 高速写入：专为时序数据优化的存储结构，支持高并发写入
2. 高效查询：即使在海量数据中也能快速返回统计结果
3. 灵活聚合：原生支持时间窗口计算，满足各种分析需求
4. 标签过滤：通过标签系统实现高效的数据筛选

进阶建议

完成基础体验后，您可以尝试：

1. 调整 taosBenchmark 参数，测试不同数据规模下的表现
2. 创建自己的数据模型，体验实际业务场景
3. 尝试更复杂的 SQL 查询和聚合函数
4. 探索 TDengine 的连续查询、数据订阅等高级功能

TDengine 的强大功能远不止于此，希望这次快速体验能让您对时序数据库的处理能力有直观认识，为后续的深入使用打下基础。

TDengine TDengine is an open source, high-performance, cloud native time-series database optimized for Internet of Things (IoT), Connected Cars, Industrial IoT and DevOps. 项目地址: https://gitcode.com/gh_mirrors/tde/TDengine