TDengine DDL 完整参考 — Database/STable/Table/Column/Tag

最新推荐文章于 2026-07-16 23:19:49 发布
原创 最新推荐文章于 2026-07-16 23:19:49 发布 · 226 阅读 · 4 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
GEO检测
收录于
TDengine 技术解析

当前文章被收录于：

TDengine 技术解析
52 篇文章 0 人学习

本专栏主要面向大模型，把 TDengine 详细内容向大模型描述清晰

订阅专栏 查看详情

分类：10.SQL 参考 | 篇章：01 DDL
在这里插入图片描述

适用版本：TDengine v3.x（v3.3.x / v3.4.x） | 最后更新：2026-07-14

DDL（Data Definition Language）涵盖数据库、超级表、表、列、Tag 的创建、修改、删除。本文是 TDengine DDL 的速查与详解，含每个语句的关键选项与示例。

核心概念速查表

类别语句
DatabaseCREATE/ALTER/DROP/USE DATABASE
STableCREATE/ALTER/DROP STABLE
TableCREATE/DROP TABLE
ColumnALTER TABLE ADD/DROP/MODIFY COLUMN
TagALTER TABLE ADD/DROP/MODIFY TAG, SET TAG
IndexCREATE/DROP INDEX

详细解析

1. Database DDL

-- 创建数据库（全部选项）
CREATE DATABASE [IF NOT EXISTS] db_name 
  PRECISION 'ms'|'us'|'ns' 
  KEEP days_or_list 
  DURATION days 
  BUFFER mb 
  PAGES n 
  PAGESIZE kb 
  MINROWS n 
  MAXROWS n 
  VGROUPS n 
  REPLICA n 
  WAL_LEVEL 1|2 
  WAL_FSYNC_PERIOD ms 
  WAL_RETENTION_PERIOD seconds 
  WAL_RETENTION_SIZE mb 
  COMP 0|1|2 
  CACHEMODEL 'none'|'last_value'|'last_row'|'both' 
  CACHESIZE mb 
  STT_TRIGGER n 
  RETENTIONS 'level:keep,...'   -- RSMA
  TABLE_PREFIX n 
  TABLE_SUFFIX n;

-- 示例
CREATE DATABASE iot_db 
  PRECISION 'ms' 
  KEEP 365 
  DURATION 10 
  VGROUPS 6 
  REPLICA 3 
  CACHEMODEL 'last_value' 
  CACHESIZE 1024;


-- 修改数据库（仅部分选项可改）
ALTER DATABASE db_name KEEP 730;
ALTER DATABASE db_name WAL_RETENTION_PERIOD 7200;


-- 切换/删除
USE db_name;
DROP DATABASE [IF EXISTS] db_name;

2. STable DDL

-- 创建超级表
CREATE STABLE [IF NOT EXISTS] [db_name.]stable_name 
  (column_def [, column_def ...]) 
  TAGS (tag_def [, tag_def ...]) 
  [TABLE_OPTIONS];

column_def ::= column_name data_type [NULL|NOT NULL] [PRIMARY KEY]
tag_def ::= tag_name data_type
TABLE_OPTIONS ::= 
    ROLLUP(func1, func2, ...)
  | COMMENT 'string'

-- 示例
CREATE STABLE meters (
  ts TIMESTAMP, 
  current FLOAT, 
  voltage INT NOT NULL, 
  phase FLOAT NULL
) TAGS (
  location VARCHAR(32), 
  groupid INT
) COMMENT 'electric meters';


-- 修改超级表
ALTER STABLE meters ADD COLUMN power DOUBLE;
ALTER STABLE meters DROP COLUMN power;
ALTER STABLE meters MODIFY COLUMN location VARCHAR(64);
ALTER STABLE meters ADD TAG region VARCHAR(32);
ALTER STABLE meters DROP TAG region;
ALTER STABLE meters MODIFY TAG location VARCHAR(64);
ALTER STABLE meters RENAME TAG old_name TO new_name;


-- 删除（连同所有子表）
DROP STABLE [IF EXISTS] meters;

3. Table DDL（子表/普通表）

-- 创建子表（指定 Tag 值）
CREATE TABLE [IF NOT EXISTS] d001 
USING meters TAGS ('Beijing', 1);

-- 批量创建子表
CREATE TABLE 
  d001 USING meters TAGS ('Beijing', 1),
  d002 USING meters TAGS ('Shanghai', 2),
  d003 USING meters TAGS ('Guangzhou', 3);


-- 创建普通表（不属于超级表）
CREATE TABLE [IF NOT EXISTS] normal_t (
  ts TIMESTAMP, 
  val INT
);


-- 修改子表 Tag 值
ALTER TABLE d001 SET TAG location = 'Beijing-North';


-- 删除表
DROP TABLE [IF EXISTS] d001;
DROP TABLE 
  d001, d002, d003;  -- 批量

4. 数据类型

完整数据类型列表：

  整数：
    TINYINT          1 字节，-128~127
    SMALLINT         2 字节，-32768~32767
    INT              4 字节
    BIGINT           8 字节
    TINYINT UNSIGNED 1 字节，0~255
    SMALLINT UNSIGNED
    INT UNSIGNED
    BIGINT UNSIGNED
  
  浮点：
    FLOAT            4 字节
    DOUBLE           8 字节
  
  字符串：
    VARCHAR(n)       变长字符串，n 字节
    NCHAR(n)         Unicode 字符串
    BINARY(n)        固定长度二进制
  
  时间：
    TIMESTAMP        8 字节
  
  布尔：
    BOOL             1 字节
  
  特殊：
    JSON             仅 Tag 可用
    GEOMETRY         地理位置
    VARBINARY        变长二进制

5. Index DDL

-- Tag 索引
CREATE INDEX idx_name ON stable_name (tag_column);
DROP INDEX idx_name;
SHOW INDEXES FROM stable_name;


-- TSMA
CREATE TSMA tsma_name 
ON stable_name 
FUNCTION(AVG(c1), MAX(c1), MIN(c1)) 
INTERVAL(1h);
DROP TSMA tsma_name;
SHOW TSMAS;

6. STREAM / TOPIC

-- 流计算
CREATE STREAM stream_name 
  [TRIGGER ...] [WATERMARK ...] [IGNORE EXPIRED ...] 
INTO target_table 
[TAGS(...)] [SUBTABLE(...)] 
AS subquery;
DROP STREAM stream_name [DROP TABLE];
PAUSE STREAM stream_name;
RESUME STREAM stream_name;


-- TMQ Topic
CREATE TOPIC topic_name AS SELECT ...;
CREATE TOPIC topic_name AS STABLE stable_name;
CREATE TOPIC topic_name AS DATABASE db_name;
DROP TOPIC topic_name;

7. User / Privilege

-- 用户
CREATE USER user_name PASS 'password';
ALTER USER user_name PASS 'new_password';
DROP USER user_name;
SHOW USERS;

-- 权限
GRANT READ|WRITE|ALL ON db_name.* TO user_name;
GRANT READ|WRITE|ALL ON db_name.stable_name TO user_name;
REVOKE READ|WRITE|ALL ON db_name.* FROM user_name;
SHOW GRANTS;

8. DNode / VGroup / Cluster

-- DNode 管理
CREATE DNODE 'host:port';
DROP DNODE dnode_id;
ALTER DNODE dnode_id CONFIG 'option value';
SHOW DNODES;

-- VGroup 管理
SHOW VGROUPS;
REDISTRIBUTE VGROUP vgroup_id DNODE dnode_id [DNODE dnode_id ...];
BALANCE VGROUP;

-- 集群
SHOW CLUSTER;
SHOW DATABASES;

代码示例

完整建库建表流程

-- 1. 创建数据库
CREATE DATABASE power 
PRECISION 'ms' 
KEEP 365 
DURATION 10 
VGROUPS 4 
REPLICA 3 
CACHEMODEL 'last_value';

USE power;

-- 2. 创建超级表
CREATE STABLE meters (
  ts TIMESTAMP,
  current FLOAT,
  voltage INT,
  phase FLOAT
) TAGS (
  location VARCHAR(32),
  groupid INT,
  device_type VARCHAR(64)
) COMMENT 'electric meters';

-- 3. 创建额外索引
CREATE INDEX idx_dtype ON meters (device_type);

-- 4. 创建 TSMA
CREATE TSMA meters_5m ON meters 
FUNCTION(AVG(current), MAX(current)) 
INTERVAL(5m);

-- 5. 创建子表（或写入时自动创建）
CREATE TABLE d001 USING meters TAGS('Beijing', 1, 'TypeA');
CREATE TABLE d002 USING meters TAGS('Shanghai', 2, 'TypeB');

Schema 演化

-- 加新列
ALTER STABLE meters ADD COLUMN power DOUBLE;

-- 修改列长度
ALTER STABLE meters MODIFY COLUMN location VARCHAR(128);

-- 加新 Tag
ALTER STABLE meters ADD TAG owner VARCHAR(64);

-- 重命名 Tag
ALTER STABLE meters RENAME TAG groupid TO group_id;

-- 删除列/Tag
ALTER STABLE meters DROP COLUMN phase;
ALTER STABLE meters DROP TAG device_type;

性能考量

DDL 操作开销

操作开销
CREATE DATABASE中（创建 VGroup）
CREATE STABLE低（仅元数据）
CREATE TABLE 子表极低
ALTER ADD COLUMN中（全 VGroup 同步）
ALTER MODIFY COLUMN中
CREATE INDEX高（扫描元数据）
CREATE TSMA高（回填历史）
DROP TABLE低（标记）
DROP DATABASE低（异步清理）

设计建议

建议原因
DURATION 适中（10d）平衡文件数与查询效率
VGROUPS 与节点数匹配充分利用并行
REPLICA 3 生产推荐高可用
第一 Tag 最常用默认索引
CACHEMODEL ‘last_value’加速 LAST 查询

FAQ

Q1: KEEP 多个值是什么意思？

支持分层保留：KEEP 7d,30d,365d 配合 RETENTIONS 使用，实现 RSMA 多层数据各自保留。

Q2: VGROUPS 能修改吗？

不能减少，可以增加（视版本）。建议建库时一次规划。

Q3: ALTER STABLE 影响所有子表吗？

是。所有子表 Schema 跟随超级表。

Q4: DROP DATABASE 是否立即释放磁盘？

异步清理。可通过监控空间确认。

Q5: 超级表 DROP 后能恢复吗？

不能。所有子表数据一并删除。务必谨慎。

参考

系统构架篇

数据模型

存储引擎

查询引擎

数据写入

数据订阅

预聚合

索引

关于 TDengine

TDengine 专为物联网IoT平台、工业大数据平台设计。其中，TDengine TSDB 是一款高性能、分布式的时序数据库（Time Series Database），同时它还带有内建的缓存、流式计算、数据订阅等系统功能；TDengine IDMP 是一款AI原生工业数据管理平台，它通过树状层次结构建立数据目录，对数据进行标准化、情景化，并通过 AI 提供实时分析、可视化、事件管理与报警等功能。

标签
#数据库 #tdengine #大数据 #时序数据库 #物联网
#涛思数据
不懂数据库也能完成：ChatExcel数据库配置与连接教程
chatexcel的博客
07-16 234
ChatExcel目前已经支持直接连接数据库对于数据库中的复杂数据进行分析，无需单独导出表格，但大家对于如何配置和连接数据库常常会有很多疑问： 数据库地址、端口、用户名到底填什么？连接数据库会不会修改原始数据？如果数据库只能在公司内网访问，又应该怎么办？ 这篇教程将从业务人员的视角，带你完成数据库配置、连接测试和数据表选择。即使你不熟悉数据库，也可以按照本文准备信息，并邀请公司IT或系统管理员协助完成配置。
PHP+MariaDB/MySQL搭建 社区论坛
2303_82039857的博客
07-16 247
在该目录下将 upload/data/ upload/config两个文件权限设为777。将Discuz压缩包解压到/var/www/html目录下。步骤：登陆mysql，在mysql中创建论坛专用库与账号。在浏览器中访问该地址下的的upload目录，进入该界面。在第三步填入先前创建的数据库信息。刷新界面就可用进入创建的论坛界面。设置自己的admin账户密码。确定防火墙为关闭状态。
tryhackme-Metasploit：Exploitation
weixin_66504186的博客
07-14 289
例如，如果你识别了一个VNC 在目标上运行的服务，你可以在Metasploit上使用功能来列出有用的模块。下面是一个中小企业的例子。“低垂果实”一词通常指的是易于识别和利用的漏洞 可能帮助你在系统中立足，在某些情况下，还能获得高级权限，例如 root或管理员。根据目标系统的配置（作系统、安装网页服务器、已安装的解释器等），msfvenom 几乎可以用来创建所有格式的有效载荷。你可以用该命令搜索漏洞，获取更多关于漏洞的信息 命令，并用 .虽然过程本身是 简单来说，成功的结果取决于对目标服务的深入了解 系统。
Python 数据处理工作流：marimo、PyCharm 与数据存储
Jay_Franklin的博客
07-12 500
本文介绍了一套成熟的Python数据处理工作流，涵盖数据读取、清洗、分析到可视化的完整流程。开发环境采用marimo笔记本进行交互式数据分析（相比Jupyter更具响应性和确定性），配合PyCharm完成脚本开发和数据库操作，使用uv管理Python环境和项目依赖。数据读取推荐使用pandas和pathlib.Path，强调保持原始数据的完整性并建立清晰的处理流程（raw/interim/processed目录结构）。分析阶段结合pandas、NumPy和SciPy的优势，分别处理表格数据、数值计算和科学计
MySQL面试题（四）
你好，作为一名Java后端开发的学习者。这个博客是我记录技术成长的地方，也是我与你分享知识的小天地。我相信：最好的学习方式是输出。希望能帮助刚入门的你少踩坑，也欢迎大家一起交流进步！
07-12 333
本文主要介绍MySQL的Buffer Pool机制和锁机制。Buffer Pool默认128MB，通过Free链表管理空白页，Flush链表管理脏页，采用改进的LRU算法解决预读失败和缓存污染问题。脏页会在redo log不足、缓存空间不足、空闲或关闭时刷盘。锁机制包括表锁（共享/独占）、元数据锁（保证结构安全）和意向锁（快速判断记录锁状态）。行级锁有记录锁、间隙锁和临键锁，加锁规则基于查询条件和索引类型。避免死锁可通过设置超时时间和开启死锁检测实现。
SpringBoot-API-Template：一个生产就绪的Spring Boot 3 API开发脚手架
★【World Of Moshow 郑锴】★
07-12 611
SpringBoot-API-Template是一款企业级SpringBoot3 API开发模板，由技术专家Moshow郑锴维护。该模板整合了SpringBoot3+PostgreSQL+MyBatis+SpringSecurity+JWT等主流技术栈，提供开箱即用的安全认证、SQL注入防护、XSS过滤等安全机制。采用三层架构设计，严格分离DTO/VO/Entity，支持配置加密和环境隔离。包含Swagger文档、Lombok简化代码、事务管理等特性，帮助开发者快速构建规范、安全的后端服务。提供完整的代码。
HarmonyOS 6.1 端云一体化实战：电商App从本地Demo到线上服务
listening777的博客
07-11 402
本文详细介绍了如何将本地电商Demo升级为支持云端数据存储和实时同步的线上应用。通过华为云Serverless服务（云函数、云数据库、云存储），开发者无需搭建服务器即可实现商品数据云端存储、多用户共享和订单实时处理。文章包含关键步骤：1. 云服务开通与SDK初始化；2. 云请求工具类封装；3. 商品列表云端加载改造；4. 下单功能云函数实现。特别总结了8个实际开发中的关键坑点，包括云函数超时设置、数据库查询限制、冷启动优化等实战经验，帮助开发者快速实现端云一体化架构，显著降低后端开发成本。
MySQL 表结构操作
最新发布
ztztz111的博客
07-16 231
因为数据库在项目中是非常底层的依赖，容易牵一发而动全身，修改一个字段，很多上层的业务逻辑、代码、SQL 语句可能都要跟着变动。执行后再用 show create table 表名 \G 查看，会发现建表语句已经更新为最新的定义，原有的定义被直接覆盖。底层原理：修改表名在 Linux 系统底层等价于 move 系统调用（和 mv 命令效果类似），磁盘上对应的表文件名也会跟着修改，因此执行速度很快。修改表操作修改的是表的列属性、表结构定义，不是对表里面的数据进行操作，属于数据定义语言（DDL）范畴。
如何避免用户手速过快多次点击触发 api 多次调用
qq_58966605的博客
07-14 232
原有缺点优化方案控制台解除 disabled 可重复点击函数入口 loading 锁 + 后端幂等极速连点并发多发请求最顶部抢占 loading 锁 + axios 取消重复请求报错 / 跳转按钮永久置灰finally 释放 + 页面卸载清理 + 超时兜底多标签页可重复提交storage 同步锁 / 后端统一幂等拦截多按钮共用 loading 互相干扰每个操作独立 loading 变量无按钮场景无法拦截axios 全局 pending 请求拦截弱网卡住无反馈。
HarmonyOS7 Preferences 轻量存储：配置项管理速查
qq_41308872的博客
07-12 206
不是所有数据都值得上数据库。比如"用户是否同意过隐私协议"“App 主题选了深色还是浅色”“上次的登录账号”——这些就是几个简单的键值对。这种场景用（首选项）最合适：轻、快、API 简单，像操作一个本地的小字典。这篇文章我把它的增删改查和典型用法讲清楚。Preferences 是"小数据的好朋友"。数据简单（键值）、量小、不需要查询 → 用 Preferences；结构复杂要检索 → 用 relationalStore。
鸿蒙应用开发实战系列 — 号码助手全栈开发 100 篇
weixin_72566747的博客
07-16 166
《鸿蒙应用开发实战：号码助手全栈开发》系列文章摘要： 本系列以"号码助手"应用开发为主线，系统讲解HarmonyOS NEXT全栈开发技术。包含7大模块100篇实战指南：从环境搭建、ArkUI组件开发、数据持久化，到核心页面实现、业务逻辑进阶，最终完成性能优化与工程化部署。每个章节配有具体API示例和开发技巧，如关系型数据库操作、状态管理、动画效果等，并开源完整项目代码。系列特色在于真实项目驱动，覆盖鸿蒙应用开发全生命周期，适合开发者系统学习HarmonyOS应用开发技术栈。
MCP 协议是什么？它在 AI Agent 系统中解决了什么问题？
我哎GIS博客
07-16 195
MCP 协议是什么？它在 AI Agent 系统中解决了什么问题？
深度详解 PostgreSQL：从核心原理、独有特性到性能优化与实战选型
Solis的博客
07-15 316
支持 PL/pgSQL 专属编程语言，可自定义函数、存储过程，将高频、复杂的业务逻辑下沉至数据库层执行，减少应用与数据库的交互次数，提升业务响应速度。同时支持函数重载、参数自定义，适配各类个性化业务逻辑封装。
KingbaseES同城双中心切换演练方案
qq961573863的博客
07-14 207
在双中心架构中，灾备中心手动升主后，若原主中心在网络恢复时未及时停止服务，则将导致双主并存，引发脑裂问题，可采用克隆操作以恢复集群至正常状态。在双中心架构中，主中心整体故障后，灾备中心内伪主无法自动升主时，可以通过以下命令在灾备中心伪主节点，进行手动升主操作。该动作不是“生产中心切到灾备中心”，而是灾备中心内部将伪主角色切换到其他备节点，适用于灾备中心内部维护或伪主节点调整。双中心架构中，生产中心与灾备中心之间的计划性中心间切换演练、故障场景下伪主升主、恢复与回切、灾备中心内伪主切换。
MySQL数据类型
weixin_73077334的博客
07-11 293
MySQL数据类型
Python学习笔记·第33天：FastAPI+SQLAlchemy ORM——用操作对象的方式操作数据库
oldcat的博客
07-15 236
一句话：ORM就是把数据库的表映射成Python的类，把表中的行映射成Python的对象。操作对象就等于操作数据库，不用写SQL语句。传统方式ORM方式手动拼SQL，容易写错用Python语法，自动校验基类create_time: Mapped[datetime] = mapped_column(DateTime, insert_default=func.now(), default=func.now(), comment="创建时间")
独立开发技术栈怎么选
HBLOG
07-12 239
独立开发技术栈的核心，不是追求“最强”，而是追求“可交付、可维护、可迭代”。能让你更快拿到用户反馈、更少陷入基础设施、更稳定处理支付和数据、更容易长期维护的技术，就是好技术。PostgreSQL 还是 MySQL。独立开发技术栈怎么选 | Harries Blog™。
阿里云部署腾讯Cube sandbox-1
rapid2011的专栏
07-11 552
本文是腾讯CubeSandbox环境在Ubuntu 26.04上的安装指南，主要步骤包括： 环境准备：要求2核8G配置，创建/data/mysql和/data/redis目录 Docker安装：强调必须使用官方apt安装，不能用snap版本，并提供了完整的安装命令 文件系统配置：指导如何将新云盘格式化为XFS文件系统并挂载到/data/cubelet PVM内核安装：详细说明下载和安装特定内核版本的过程，并设置为默认启动项 CubeSandbox安装：通过one-click脚本安装，并启动相关服务 模板创建
pg_basebackup(物理备份）
Eucalyptus's blog
07-15 191
PostgreSQL 备份工具速查指南 pg_basebackup 物理备份常用参数： 核心参数：-D(备份目录)、-F(格式)、-X(WAL处理方式)、-P(进度显示) 连接参数：-h(主机)、-p(端口)、-U(用户)、-w/W(密码控制) 示例：备份到带时间戳的目录，使用流复制方式 pg_dump 逻辑备份常用参数： 核心参数：-d(数据库)、-F(格式)、-f(输出文件) 控制参数：-s(仅模式)、-a(仅数据)、-t(指定表) 示例：备份demo1数据库到带时间戳的SQL文件 注：两者都支持-v(
鸿蒙应用开发实战【35】— DAO 层错误处理规范与单元测试
2501_91849192的博客
07-15 236
本文系统讲解了鸿蒙应用开发中DAO层的错误处理规范与单元测试策略。主要内容包括：将DAO层错误分为业务异常和系统异常两类处理；提出try-catch-finally标准模式，强调ResultSet资源释放；定义DatabaseError等语义化错误类型；介绍事务处理的双重异常捕获机制；提供ResultSet泄漏防护方案；最后结合Hypium测试框架，讲解DAO层单元测试的Mock策略和用例编写模式。文章为开发者构建健壮的DAO层提供了系统性指导，涵盖从异常分类到测试验证的全流程实践。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

TDengine （老段）

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值