开发指南

开发一个应用，如果你准备采用 TDengine TSDB 作为时序数据处理的工具，那么有如下几个事情要做：

1. 确定应用到 TDengine TSDB 的连接方式。无论你使用何种编程语言，你总是可以使用 REST 接口，但也可以使用每种编程语言独有的连接器进行方便的连接。
2. 根据自己的应用场景，确定数据模型。根据数据特征，决定建立一个还是多个库；分清静态标签、采集量，建立正确的超级表，建立子表。
3. 决定插入数据的方式。TDengine TSDB 支持使用标准的 SQL 写入，但同时也支持 Schemaless 模式写入，这样不用手工建表，可以将数据直接写入。
4. 根据业务要求，看需要撰写哪些 SQL 查询语句。
5. 如果你要基于时序数据做轻量级的实时统计分析，包括各种监测看板，那么建议你采用 TDengine TSDB 3.0 的流式计算功能，而不用额外部署 Spark、Flink 等复杂的流式计算系统。
6. 如果你的应用有模块需要消费插入的数据，希望有新的数据插入时，就能获取通知，那么建议你采用 TDengine TSDB 提供的数据订阅功能，而无需专门部署 Kafka 或其他消息队列软件。
7. 在很多场景下（如车辆管理），应用需要获取每个数据采集点的最新状态，那么建议你采用 TDengine TSDB 的 Cache 功能，而不用单独部署 Redis 等缓存软件。
8. 如果你发现 TDengine TSDB 的函数无法满足你的要求，那么你可以使用用户自定义函数（UDF）来解决问题。

本部分内容就是按照上述顺序组织的。为便于理解，TDengine TSDB 为每个功能和每个支持的编程语言都提供了示例代码，位于 示例代码。所有示例代码都会有 CI 保证正确性，脚本位于 示例代码 CI。 如果你希望深入了解 SQL 的使用，需要查看 SQL 手册。如果想更深入地了解各连接器的使用，请阅读 连接器参考指南。如果还希望想将 TDengine TSDB 与第三方系统集成起来，比如 Grafana，请参考 第三方工具。

如果在开发过程中遇到任何问题，请点击每个页面下方的 反馈问题，在 GitHub 上直接递交 Issue。

📄️ 建立连接

安装客户端驱动 taosc

📄️ 执行 SQL

TDengine TSDB 对 SQL 语言提供了全面的支持，允许用户以熟悉的 SQL 语法进行数据的查询、插入和删除操作。TDengine TSDB 的 SQL 还支持对数据库和数据表的管理操作，如创建、修改和删除数据库及数据表。TDengine TSDB 扩展了标准 SQL，引入了时序数据处理特有的功能，如时间序列数据的聚合查询、降采样、插值查询等，以适应时序数据的特点。这些扩展使得用户可以更高效地处理时间序列数据，进行复杂的数据分析和处理。具体支持的 SQL 语法请参考 TDengine TSDB SQL

📄️ 无模式写入

在物联网应用中，为了实现自动化管理、业务分析和设备监控等多种功能，通常需要采集大量的数据项。然而，由于应用逻辑的版本升级和设备自身的硬件调整等原因，数据采集项可能会频繁发生变化。为了应对这种挑战，TDengine TSDB 提供了无模式（schemaless）写入方式，旨在简化数据记录过程。

📄️ 参数绑定

参数绑定（Prepared Statement）是一种预编译 SQL 语句并通过参数化方式传递数据的技术。

📄️ 数据订阅

TDengine TSDB 提供了类似于消息队列产品的数据订阅和消费接口。在许多场景中，采用 TDengine TSDB 的时序大数据平台，无须再集成消息队列产品，从而简化应用程序设计并降低运维成本。本章介绍各语言连接器数据订阅的相关 API 以及使用方法。数据订阅的基础知识请参考 数据订阅 。

📄️ UDF

UDF 简介

📄️ 高效写入

为帮助用户轻松构建百万级吞吐量的数据写入管道，TDengine TSDB 连接器提供高效写入的特性。启动高效写入特性后，TDengine TSDB 连接器将自动创建写入线程与专属队列，将数据按子表切分缓存，在达到数据量阈值或超时条件时批量发送，以此减少网络请求、提升吞吐量，让用户无需掌握多线程编程知识和数据切分技巧即可实现高性能写入。