时序数据库SQL开发指南：建库建表与数据写入详解

Xiaxin Li

2026-04-30 / 时序数据库知识

对于熟悉关系型数据库的开发者来说，时序数据库的SQL语法学习成本极低。作为一款专业的时序数据库，它不仅全面支持标准SQL的查询、插入和删除操作，还针对时间序列数据场景进行了功能扩展。本文将围绕建库建表和数据写入两大核心操作，详细介绍时序数据库的SQL开发要点。

SQL语言支持概述

时序数据库对SQL语言提供了全面的支持，允许用户以熟悉的SQL语法进行数据的查询、插入和删除操作。在此基础上，时序数据库还扩展了标准SQL，引入了时序数据处理特有的功能，包括时间序列数据的聚合查询、降采样、插值查询等。这意味着开发者可以复用已有的SQL知识，在时序数据库上快速上手时序数据的开发工作。

建库操作

创建数据库是使用时序数据库的第一步，也是时序数据库应用开发的基础。以下是一个标准的建库语句：

CREATE DATABASE IF NOT EXISTS power

IF NOT EXISTS子句确保了操作的幂等性，在数据库已存在时不会报错。这一特性在自动化部署和脚本化运维中非常实用。

在实际应用中，建库时还可以指定多种参数，如数据保留天数、副本数量、缓存大小等。这些参数的合理配置对于时序数据库的存储效率和查询性能至关重要。

建表操作：超级表与子表

时序数据库采用超级表（STABLE）和子表的层次结构来组织数据，这是时序数据库独有的数据模型设计。超级表定义了数据 schema，子表则是时序数据库中具体的数据存储单元。

创建超级表

CREATE STABLE IF NOT EXISTS power.meters (ts TIMESTAMP, current FLOAT, voltage INT, phase FLOAT) TAGS (groupId INT, location BINARY(24))

在这个示例中，power.meters是超级表的完整名称，采用了dbName.tableName的格式。超级表包含四个数据列和一个时间戳主键列，以及两个标签列（groupId和location）。

设计要点：

ts TIMESTAMP：时间戳列是时序数据库的主键，每张表必须包含
current FLOAT, voltage INT, phase FLOAT：普通数据列，记录采集的数值
TAGS (groupId INT, location BINARY(24))：标签列用于标识数据来源，标签列的值在子表级别是固定的

超级表本身不存储数据，它相当于一个模板。实际的数据写入和查询都在子表上进行。

子表的创建方式

子表可以通过以下方式创建：

方式一：手动创建后写入数据。 先使用CREATE TABLE语句创建子表，再执行INSERT语句写入数据。

方式二：使用自动建表语法。 在INSERT语句中直接指定子表所属的超级表和标签值，系统会自动创建子表并写入数据。这种方式更为简洁高效，是推荐的实践。

数据写入详解

自动建表写入

时序数据库支持自动建表语法，可以在写入数据的同时创建子表，这是时序数据库简化开发流程的重要特性：

INSERT INTO power.d1001 USING power.meters TAGS(2,'California.SanFrancisco') VALUES (NOW + 1a, 10.30000, 219, 0.31000)

这条语句的含义是：

power.d1001：目标子表名
USING power.meters：指定该子表所属的超级表
TAGS(2,'California.SanFrancisco')：子表的标签值
VALUES (NOW + 1a, 10.30000, 219, 0.31000)：写入的数据值

时间函数与时间偏移

时序数据库提供了灵活的时间表达式支持，这是时序数据库在数据写入方面的一大优势。NOW为系统内部函数，默认取客户端所在计算机的当前时间。在此基础上，支持通过加减运算指定时间偏移：

NOW + 1s   -- 客户端当前时间往后加1秒
NOW + 1a   -- 客户端当前时间往后加1毫秒
NOW + 1m   -- 客户端当前时间往后加1分钟
NOW + 1h   -- 客户端当前时间往后加1小时
NOW + 1d   -- 客户端当前时间往后加1天
NOW + 1w   -- 客户端当前时间往后加1周
NOW + 1n   -- 客户端当前时间往后加1月
NOW + 1y   -- 客户端当前时间往后加1年

时间单位字母对照：a（毫秒）、s（秒）、m（分）、h（小时）、d（天）、w（周）、n（月）、y（年）。这种灵活的时间偏移语法在批量写入历史数据或模拟数据时非常方便。

SQL编写最佳实践

在实际开发中，时序数据库的SQL编写需要遵循一些最佳实践，以充分发挥时序数据库的性能优势：

使用dbName.tableName格式： 建议在SQL语句中采用dbName.tableName的完整格式来引用表，而不是使用USE DBName方式切换数据库。这一建议在连接池环境下尤为重要，因为USE语句可能导致不同请求之间的数据库上下文混乱。

合理利用自动建表： 在物联网场景中，设备数量可能非常庞大且动态变化。使用自动建表语法可以简化代码逻辑，避免预先创建大量子表的繁琐操作。

注意数据类型选择： 时序数据库支持FLOAT、INT、BINARY、NCHAR等多种数据类型。对于标签列，BINARY和NCHAR需要指定长度，如BINARY(24)。如果后续写入的数据超出预设长度，在无模式写入方式下系统会自动扩展列长度。

时序特有的查询功能

除了标准的增删改查操作，时序数据库还提供了针对时间序列数据的专用查询功能，这些功能是时序数据库的核心竞争力所在：

聚合查询： 对时间窗口内的数据进行统计聚合，如求平均值、最大值、最小值等
降采样： 将高频率采集的数据按时间窗口降采样，减少数据量同时保留趋势信息
插值查询： 对缺失的时间点数据进行插值填充，确保时间序列的连续性

这些功能是时序数据库区别于传统关系型数据库的核心能力，能够显著简化时序数据库中时序数据的分析工作。

总结

掌握时序数据库的SQL语法是高效开发的基础。从建库建表到数据写入，时序数据库的SQL设计充分考虑了时间序列数据的特点，在保持标准SQL兼容性的同时，通过超级表/子表模型、自动建表语法、灵活的时间表达式等时序数据库特有的功能，大幅降低了开发复杂度。遵循dbName.tableName的SQL编写规范、善用自动建表语法和时间偏移表达式，能够帮助开发者构建更加健壮和高效的数据处理流程。作为一款专为时序数据设计的数据库引擎，TDengine在SQL层面的扩展使其既能满足传统数据库用户的操作习惯，又能充分发挥时序数据的处理优势。