Merge pull request #11514 from taosdata/docs/TD-14750

docs: refine some documents in advanced features, reference guide and…

docs-cn/08-advance-feature/01-continuous-query.mdx

@@ -12,7 +12,7 @@ TDengine 提供的连续查询与普通流计算中的时间窗口计算具有
 
 - 不同于流计算的实时反馈计算结果，连续查询只在时间窗口关闭以后才开始计算。例如时间周期是 1 天，那么当天的结果只会在 23:59:59 以后才会生成。
 - 如果有历史记录写入到已经计算完成的时间区间，连续查询并不会重新进行计算，也不会重新将结果推送给用户。对于写回 TDengine 的模式，也不会更新已经存在的计算结果。
-- 使用连续查询推送结果的模式，服务端并不缓存客户端计算状态，也不提供 Exactly-Once 的语意保证。如果用户的应用端崩溃，再次拉起的连续查询将只会从再次拉起的时间开始重新计算最近的一个完整的时间窗口。如果使用写回模式，TDengine 可确保数据写回的有效性和连续性。
+- 使用连续查询推送结果的模式，服务端并不缓存客户端计算状态，也不提供 Exactly-Once 的语义保证。如果用户的应用端崩溃，再次拉起的连续查询将只会从再次拉起的时间开始重新计算最近的一个完整的时间窗口。如果使用写回模式，TDengine 可确保数据写回的有效性和连续性。
 
 ## 使用连续查询
 

docs-cn/08-advance-feature/02-subscribe.mdx

@@ -14,7 +14,7 @@ import Node from "./_sub_node.mdx";
 import CSharp from "./_sub_cs.mdx";
 import CDemo from "./_sub_c.mdx";
 
-基于数据天然的时间序列特性，TDengine 的数据写入（insert）与消息系统的数据发布（pub）逻辑上一致，均可视为系统中插入一条带时间戳的新记录。同时，TDengine 在内部严格按照数据时间序列单调递增的方式保存数据。本质上来说，TDengine 中里每一张表均可视为一个标准的消息队列。
+基于数据天然的时间序列特性，TDengine 的数据写入（insert）与消息系统的数据发布（pub）逻辑上一致，均可视为系统中插入一条带时间戳的新记录。同时，TDengine 在内部严格按照数据时间序列单调递增的方式保存数据。本质上来说，TDengine 中每一张表均可视为一个标准的消息队列。
 
 TDengine 内嵌支持轻量级的消息订阅与推送服务。使用系统提供的 API，用户可使用普通查询语句订阅数据库中的一张或多张表。订阅的逻辑和操作状态的维护均是由客户端完成，客户端定时轮询服务器是否有新的记录到达，有新的记录到达就会将结果反馈到客户。
 

docs-cn/11-operation/09-status.md

@@ -2,40 +2,52 @@
 title: 系统连接、任务查询管理
 ---
 
-系统管理员可以从 CLI 查询系统的连接、正在进行的查询、流式计算，并且可以关闭连接、停止正在进行的查询和流式计算。CLI 里 SQL 语法如下：
+系统管理员可以从 CLI 查询系统的连接、正在进行的查询、流式计算，并且可以关闭连接、停止正在进行的查询和流式计算。
+
+## 显示数据库的连接
 
 ```sql
 SHOW CONNECTIONS;
 ```
 
-显示数据库的连接，其中一列显示 ip:port, 为连接的 IP 地址和端口号。
+其结果中的一列显示 ip:port, 为连接的 IP 地址和端口号。
+
+## 强制关闭数据库连接
 
 ```sql
 KILL CONNECTION <connection-id>;
 ```
 
-强制关闭数据库连接，其中的 connection-id 是 SHOW CONNECTIONS 中显示的第一列的数字。
+其中的 connection-id 是 SHOW CONNECTIONS 中显示的第一列的数字。
+
+## 显示数据查询
 
 ```sql
 SHOW QUERIES;
 ```
 
-显示数据查询，其中第一列显示的以冒号隔开的两个数字为 query-id，为发起该 query 应用连接的 connection-id 和查询次数。
+其中第一列显示的以冒号隔开的两个数字为 query-id，为发起该 query 应用连接的 connection-id 和查询次数。
+
+## 强制关闭数据查询
 
 ```sql
 KILL QUERY <query-id>;
 ```
 
-强制关闭数据查询，其中 query-id 是 SHOW QUERIES 中显示的 connection-id:query-no 字串，如“105:2”，拷贝粘贴即可。
+其中 query-id 是 SHOW QUERIES 中显示的 connection-id:query-no 字串，如“105:2”，拷贝粘贴即可。
+
+## 显示连续查询
 
 ```sql
 SHOW STREAMS;
 ```
 
-显示流式计算，其中第一列显示的以冒号隔开的两个数字为 stream-id, 为启动该 stream 应用连接的 connection-id 和发起 stream 的次数。
+其中第一列显示的以冒号隔开的两个数字为 stream-id, 为启动该 stream 应用连接的 connection-id 和发起 stream 的次数。
+
+## 强制关闭连续查询
 
 ```sql
 KILL STREAM <stream-id>;
 ```
 
-强制关闭流式计算，其中的中 stream-id 是 SHOW STREAMS 中显示的 connection-id:stream-no 字串，如 103:2，拷贝粘贴即可。
+其中的 stream-id 是 SHOW STREAMS 中显示的 connection-id:stream-no 字串，如 103:2，拷贝粘贴即可。

docs-cn/14-reference/01-taos-sql/08-interval.md

@@ -16,13 +16,13 @@ INTERVAL 子句用于产生相等时间周期的窗口，SLIDING 用以指定窗
 INTERVAL 和 SLIDING 子句需要配合聚合和选择函数来使用。以下 SQL 语句非法：
 
 ```
-SELECT * FROM temp_table INTERVAL(1S)
+SELECT * FROM temp_tb_1 INTERVAL(1m);
 ```
 
 SLIDING 的向前滑动的时间不能超过一个窗口的时间范围。以下语句非法：
 
 ```
-SELECT COUNT(*) FROM temp_table INTERVAL(1D) SLIDING(2D)
+SELECT COUNT(*) FROM temp_tb_1 INTERVAL(1m) SLIDING(2m);
 ```
 
 当 SLIDING 与 INTERVAL 取值相等的时候，滑动窗口即为翻转窗口。
@@ -38,7 +38,7 @@ _ 从 2.1.5.0 版本开始，INTERVAL 语句允许的最短时间间隔调整为
 使用 STATE_WINDOW 来确定状态窗口划分的列。例如：
 
 ```
-SELECT COUNT(*), FIRST(ts), status FROM temp_tb_1 STATE_WINDOW(status)
+SELECT COUNT(*), FIRST(ts), status FROM temp_tb_1 STATE_WINDOW(status);
 ```
 
 ## 会话窗口
@@ -51,7 +51,7 @@ SELECT COUNT(*), FIRST(ts), status FROM temp_tb_1 STATE_WINDOW(status)
 
 ```
 
-SELECT COUNT(*), FIRST(ts) FROM temp_tb_1 SESSION(ts, tol_val)
+SELECT COUNT(*), FIRST(ts) FROM temp_tb_1 SESSION(ts, tol_val);
 ```
 
 这种类型的查询语法如下：
@@ -72,7 +72,7 @@ SELECT function_list FROM stb_name
 ```
 
 - 在聚合查询中，function_list 位置允许使用聚合和选择函数，并要求每个函数仅输出单个结果（例如：COUNT、AVG、SUM、STDDEV、LEASTSQUARES、PERCENTILE、MIN、MAX、FIRST、LAST），而不能使用具有多行输出结果的函数（例如：DIFF 以及四则运算）。
-- 此外也 LAST_ROW 查询也不能与窗口聚合同时出现。
+- 此外 LAST_ROW 查询也不能与窗口聚合同时出现。
 - 标量函数（如：CEIL/FLOOR 等）也不能使用在窗口聚合查询中。
 -
 

docs-cn/14-reference/01-taos-sql/09-limit.md

@@ -6,11 +6,12 @@ title: 边界限制
 ## 一般限制
 
 - 数据库名最大长度为 32。
-- 表名最大长度为 192，每行数据最大长度 16k 个字符, 从 2.1.7.0 版本开始，每行数据最大长度 48k 个字符（注意：数据行内每个 BINARY/NCHAR 类型的列还会额外占用 2 个字节的存储位置）。
-- 列名最大长度为 64，最多允许 1024 列，最少需要 2 列，第一列必须是时间戳。（从 2.1.7.0 版本开始，改为最多允许 4096 列）
-- 标签名最大长度为 64，最多允许 128 个，可以 1 个，一个表中标签值的总长度不超过 16k 个字符。
+- 表名最大长度为 192，不包括数据库名前缀和分隔符
+- 每行数据最大长度 16k 个字符, 从 2.1.7.0 版本开始，每行数据最大长度 48k 个字符（注意：数据行内每个 BINARY/NCHAR 类型的列还会额外占用 2 个字节的存储位置）。
+- 列名最大长度为 64，最多允许 4096 列，最少需要 2 列，第一列必须是时间戳。注：从 2.1.7.0 版本（不含)以前最多允许 4096 列
+- 标签名最大长度为 64，最多允许 128 个，至少要有 1 个标签，一个表中标签值的总长度不超过 16k 个字符。
 - SQL 语句最大长度 1048576 个字符，也可通过客户端配置参数 maxSQLLength 修改，取值范围 65480 ~ 1048576。
-- SELECT 语句的查询结果，最多允许返回 1024 列（语句中的函数调用可能也会占用一些列空间），超限时需要显式指定较少的返回数据列，以避免语句执行报错。（从 2.1.7.0 版本开始，改为最多允许 4096 列）
+- SELECT 语句的查询结果，最多允许返回 4096 列（语句中的函数调用可能也会占用一些列空间），超限时需要显式指定较少的返回数据列，以避免语句执行报错。注： 2.1.7.0 版本（不含）之前为最多允许 1024 列
 - 库的数目，超级表的数目、表的数目，系统不做限制，仅受系统资源限制。
 
 ## GROUP BY 的限制
@@ -34,17 +35,20 @@ IS NOT NULL 支持所有类型的列。不为空的表达式为 <\>""，仅对
 
 ## 表(列)名合法性说明
 
-TDengine 中的表（列）名命名规则如下：
+### TDengine 中的表（列）名命名规则如下：
 只能由字母、数字、下划线构成，数字不能在首位，长度不能超过 192 字节，不区分大小写。这里表名称不包括数据库名的前缀和分隔符。
 
-转移后表（列）名规则：
-为了兼容支持更多形式的表（列）名，TDengine 引入新的转义符 "`"。可用让表名与关键词不冲突，同时不受限于上述表名称合法性约束检查，转义符不计入表名称的长度。
+### 转义后表（列）名规则：
+为了兼容支持更多形式的表（列）名，TDengine 引入新的转义符 "`"，可以避免表名与关键词的冲突，同时不受限于上述表名合法性约束检查，转义符不计入表名的长度。
 转义后的表（列）名同样受到长度限制要求，且长度计算的时候不计算转义符。使用转义字符以后，不再对转义字符中的内容进行大小写统一。
 
 例如：
 \`aBc\` 和 \`abc\` 是不同的表（列）名，但是 abc 和 aBc 是相同的表（列）名。
 
-需要注意的是转义字符中的内容必须是可打印字符。
+:::note
+转义字符中的内容必须是可打印字符。
 
-支持版本
+:::
+
+### 支持版本
 支持转义符的功能从 2.3.0.1 版本开始。
\ No newline at end of file