TDengine TSDB 文档

TDengine TSDB 是一款 开源、高性能、云原生 的时序数据库（Time Series Database, TSDB）, 它专为物联网、车联网、工业互联网、金融、IT 运维等场景优化设计。同时它还带有内建的缓存、流式计算、数据订阅等系统功能，能大幅减少系统设计的复杂度，降低研发和运营成本，是一款极简的时序数据处理平台。本文档是 TDengine TSDB 的用户手册，主要是介绍 TDengine TSDB 的基本概念、安装、使用、功能、开发接口、运营维护、TDengine TSDB 内核设计等等，它主要是面向架构师、开发工程师与系统管理员的。如果你对时序数据的基本概念、价值以及其所能带来的业务价值尚不了解，请参考 时序数据基础。

TDengine TSDB 充分利用了时序数据的特点，提出了“一个数据采集点一张表”与“超级表”的概念，设计了创新的存储引擎，让数据的写入、查询和存储效率都得到极大的提升。为正确理解并使用 TDengine TSDB，无论你在工作中是什么角色，请您仔细阅读 数据模型 一章。

如果你是开发工程师，请一定仔细阅读 开发指南 一章，该部分对数据库连接、建模、写入、查询、流式计算、缓存、数据订阅、用户自定义函数等功能都做了详细介绍，并配有各种编程语言的示例代码。大部分情况下，只要复制粘贴示例代码，针对自己的应用稍作改动，就能跑起来。对 REST API、各种编程语言的连接器（Connector）想做更多详细了解，请看 连接器 一章。

我们已经生活在大数据时代，纵向扩展已经无法满足日益增长的业务需求，任何系统都必须具有水平扩展的能力，集群成为大数据以及 Database 系统的不可缺失功能。TDengine 团队不仅实现了集群功能，而且将这一重要核心功能开源。怎么部署、管理和维护 TDengine TSDB 集群，请仔细参考 运维管理 一章。

TDengine TSDB 采用 SQL 作为查询语言，大大降低学习成本、降低迁移成本，但同时针对时序数据场景，又做了一些扩展，以支持插值、降采样、时间加权平均等操作。SQL 手册 一章详细描述了 SQL 语法、详细列出了各种支持的命令和函数。

如果你是系统管理员，关心安装、升级、容错灾备、关心数据导入、导出、配置参数，如何监测 TDengine TSDB 是否健康运行，如何提升系统运行的性能，请仔细参考 运维指南 一章。

如果你对数据库内核设计感兴趣，或是开源爱好者，建议仔细阅读 技术内幕 一章。该章从分布式架构到存储引擎、查询引擎、数据订阅，再到流计算引擎都做了详细阐述。建议对照文档，查看 TDengine TSDB 在 GitHub 的源代码，对 TDengine TSDB 的设计和编码做深入了解，更欢迎加入开源社区，贡献代码。

2025 年 7 月，TDengine 团队推出新产品 TDengine IDMP — AI 原生的工业数据管理平台。利用 AI 大模型，它可以基于采集的数据，自动感知应用场景、自动生成面板、报表，自动进行实时数据分析。如果你有数据挖掘的需求或者面临海量数据业务洞察的难题，建议 详细了解 TDengine IDMP 并免费试用。

TDengine 培训与认证中心是涛思数据官方打造的专业能力平台，通过分层认证体系覆盖时序数据架构设计、集群化运维管理及多语言应用开发三大领域，帮助你系统掌握 TDengine 相关技能，并获得行业认可的技术认证。

目前面向运维人员和数据分析师，我们限时免费开放了可以帮助用户快速掌握产品架构、SQL 基础、部署运维等核心知识的 TCP-BP 时序数据库基础认证专员 认证考试。完成认证后，你不仅能够获得权威证书，还可加入 TDengine 开发者社区，获取专属资料与技术支持，全面提升职业竞争力。访问 TDengine 培训与认证中心 即可进入专题页面，通过阶梯考试，系统化提升技能，迈向更高技术水平。

最后，作为一个开源软件，欢迎大家的参与。如果发现文档有任何错误、描述不清晰的地方，请在每个页面的最下方，点击“编辑本文档”直接进行修改。

Together, we make a difference!