diff --git a/docs-cn/04-connect/index.mdx b/docs-cn/04-connect/index.mdx index 960f1b31d3cd7bdb84b50536aa04f51b32020e09..d9b416fdf8e2e1136a9a711ee5ffcc12dca2ac07 100644 --- a/docs-cn/04-connect/index.mdx +++ b/docs-cn/04-connect/index.mdx @@ -23,13 +23,13 @@ TDengine 提供RESTful接口,容许在任何平台的任何应用程序通过 ## 连接器建立连接的方式 连接器建立连接的方式,TDengine提供两种: - 1. 通过 taosAdapter 组件提供的 RESTful API 建立与 taosd 的连接,这种连接方式下文中简称" + 1. 通过 taosAdapter 组件提供的 RESTful API 建立与 taosd 的连接,这种连接方式下文中简称"RESTful 连接“ 2. 通过客户端驱动程序 taosc 直接与服务端程序 taosd 建立连接,这种连接方式下文中简称“本地连接”。 无论使用何种方式建立连接,连接器都提供了相同或相似的 API 操作数据库,都可以执行 SQL 语句,只是初始化连接的方式稍有不同,用户在使用上不会感到什么差别。 关键不同点在于: -1. 使用 RESTful 方式,用户无需安装客户端驱动程序 taosc,具有跨平台易用的优势,但性能要下降30%左右。 +1. 使用 RESTful 连接,用户无需安装客户端驱动程序 taosc,具有跨平台易用的优势,但性能要下降30%左右。 2. 使用本地连接可以体验 TDengine 的全部功能,如[原生接口写入](/reference/connector/cpp#参数绑定-api)、[订阅](reference/connector/cpp#数据订阅接口)等等。 diff --git a/docs-cn/06-insert-data/01-sql-writing.mdx b/docs-cn/06-insert-data/01-sql-writing.mdx index 9ea929b1bc658b36a75c51ceceea726f1b2db692..4ee79c7ad431de8d587dd67da0faaddbf2562b03 100644 --- a/docs-cn/06-insert-data/01-sql-writing.mdx +++ b/docs-cn/06-insert-data/01-sql-writing.mdx @@ -101,6 +101,8 @@ INSERT INTO d1001 VALUES (1538548685000, 10.3, 219, 0.31) (1538548695000, 12.6, TDengine 也提供了支持参数绑定的 Prepare API,与 MySQL 一样,这些 API 目前也仅支持用问号 `?` 来代表待绑定的参数。文档中有时也会把此功能称为“原生接口写入”。从 2.1.1.0 和 2.1.2.0 版本开始,TDengine 大幅改进了参数绑定接口对数据写入(INSERT)场景的支持。这样在通过参数绑定接口写入数据时,就避免了 SQL 语法解析的资源消耗,从而在绝大多数情况下显著提升写入性能。 +需要注意的是,只有使用本地连接的连接器,才能使用动态绑定功能。 + @@ -125,8 +127,3 @@ TDengine 也提供了支持参数绑定的 Prepare API,与 MySQL 一样,这 -:::note - -只有使用本地驱动方式建立连接,才能使用动态绑定功能。 - -::: diff --git a/docs-cn/07-query-data/index.mdx b/docs-cn/07-query-data/index.mdx index b36ed12ff6bb159a0975d9ffc54b6bd7ae646654..22d5285988ae320a5866bf37a9f17c2214732181 100644 --- a/docs-cn/07-query-data/index.mdx +++ b/docs-cn/07-query-data/index.mdx @@ -19,7 +19,7 @@ import CAsync from "./_c_async.mdx"; ## 主要查询功能 -TDengine 采用 SQL 作为查询语言。应用程序可以通过连接器发送 SQL 语句,用户可以通过命令行(Command Line Interface, CLI)工具 TAOS Shell 手动执行 SQL 即席查询(Ad-Hoc Query)。TDengine 支持如下查询功能: +TDengine 采用 SQL 作为查询语言。应用程序可以通过RESTful接口或连接器发送 SQL 语句,用户还可以通过 TDengine 命令行工具 taos 手动执行 SQL 即席查询(Ad-Hoc Query)。TDengine 支持如下查询功能: - 单列、多列数据查询 - 标签和数值的多种过滤条件:>, <, =, <\>, like 等 @@ -28,7 +28,7 @@ TDengine 采用 SQL 作为查询语言。应用程序可以通过连接器发送 - 时间戳对齐的连接查询(Join Query: 隐式连接)操作 - 多种聚合/计算函数: count, max, min, avg, sum, twa, stddev, leastsquares, top, bottom, first, last, percentile, apercentile, last_row, spread, diff 等 -例如:在 TAOS Shell 中,从表 d1001 中查询出 voltage > 215 的记录,按时间降序排列,仅仅输出 2 条。 +例如:在命令行工具 taos 中,从表 d1001 中查询出 voltage > 215 的记录,按时间降序排列,仅仅输出 2 条。 ```sql taos> select * from d1001 where voltage > 215 order by ts desc limit 2; @@ -114,7 +114,9 @@ taos> SELECT SUM(current) FROM meters INTERVAL(1s, 500a); Query OK, 5 row(s) in set (0.001521s) ``` -物联网场景里,每个数据采集点采集数据的时间是难同步的,但很多分析算法(比如 FFT)需要把采集的数据严格按照时间等间隔的对齐,在很多系统里,需要应用自己写程序来处理,但使用 TDengine 的降采样操作就轻松解决。如果一个时间间隔里,没有采集的数据,TDengine 还提供插值计算的功能。 +物联网场景里,每个数据采集点采集数据的时间是难同步的,但很多分析算法(比如 FFT)需要把采集的数据严格按照时间等间隔的对齐,在很多系统里,需要应用自己写程序来处理,但使用 TDengine 的降采样操作就轻松解决。 + +如果一个时间间隔里,没有采集的数据,TDengine 还提供插值计算的功能。 语法规则细节请见 [TAOS SQL 的按时间窗口切分聚合](/reference/taos-sql/interval) 章节。 @@ -150,7 +152,7 @@ Query OK, 5 row(s) in set (0.001521s) :::note -1. 无论 RESTful 方式建立连接还是本地驱动方式建立连接,以上示例代码都能正常工作。 +1. 无论是使用 RESTful 连接还是本地连接的连接器,以上示例代码都能正常工作。 2. 唯一需要注意的是:由于 RESTful 接口无状态, 不能使用 `use db` 语句来切换数据库。 ::: @@ -159,6 +161,8 @@ Query OK, 5 row(s) in set (0.001521s) 除同步查询 API 之外,TDengine 还提供性能更高的异步调用 API 处理数据插入、查询操作。在软硬件环境相同的情况下,异步 API 处理数据插入的速度比同步 API 快 2-4 倍。异步 API 采用非阻塞式的调用方式,在系统真正完成某个具体数据库操作前,立即返回。调用的线程可以去处理其他工作,从而可以提升整个应用的性能。异步 API 在网络延迟严重的情况下,优点尤为突出。 +需要注意的是,只有使用本地连接的连接器,才能使用异步查询功能。 + @@ -173,9 +177,3 @@ Query OK, 5 row(s) in set (0.001521s) */} - -:::note - -只有使用本地驱动方式连接连接,才能使用异步查询功能。 - -:::