diff --git a/docs-cn/08-advance-feature/02-subscribe.mdx b/docs-cn/08-advance-feature/02-subscribe.mdx index f9952edf56aa1e873600e804d37d1e5fa0434d62..274140868dbdf27c6cb1f6be1f4f326c51688371 100644 --- a/docs-cn/08-advance-feature/02-subscribe.mdx +++ b/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,用户可使用普通查询语句订阅数据库中的一张或多张表。订阅的逻辑和操作状态的维护均是由客户端完成,客户端定时轮询服务器是否有新的记录到达,有新的记录到达就会将结果反馈到客户。 diff --git a/docs-cn/11-operation/09-status.md b/docs-cn/11-operation/09-status.md index 18220ac3ea72b9bd7969c209fccbc29b12bfbb37..209633a596f09b0ae738a9fd9d3d4d706e07999c 100644 --- a/docs-cn/11-operation/09-status.md +++ b/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 是 SHOW CONNECTIONS 中显示的第一列的数字。 +其中的 connection-id 是 SHOW CONNECTIONS 中显示的第一列的数字。 + +## 显示数据查询 ```sql SHOW QUERIES; ``` -显示数据查询,其中第一列显示的以冒号隔开的两个数字为 query-id,为发起该 query 应用连接的 connection-id 和查询次数。 +其中第一列显示的以冒号隔开的两个数字为 query-id,为发起该 query 应用连接的 connection-id 和查询次数。 + +## 强制关闭数据查询 ```sql KILL QUERY ; ``` -强制关闭数据查询,其中 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 是 SHOW STREAMS 中显示的 connection-id:stream-no 字串,如 103:2,拷贝粘贴即可。 +其中的 stream-id 是 SHOW STREAMS 中显示的 connection-id:stream-no 字串,如 103:2,拷贝粘贴即可。 diff --git a/docs-cn/14-reference/01-taos-sql/08-interval.md b/docs-cn/14-reference/01-taos-sql/08-interval.md index ef81ba78ea5f2e0f7a87a1d43a6cd98e605dedcf..8fb3296b0495873adf1cfece0e67eae0921d34ed 100644 --- a/docs-cn/14-reference/01-taos-sql/08-interval.md +++ b/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 等)也不能使用在窗口聚合查询中。 - diff --git a/docs-cn/14-reference/01-taos-sql/09-limit.md b/docs-cn/14-reference/01-taos-sql/09-limit.md index 327ee165cc9b780a48f0e60584cecff2799b50c4..c7934685bc89d0f1a423797a162f5e280074b562 100644 --- a/docs-cn/14-reference/01-taos-sql/09-limit.md +++ b/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 列) +- 表名最大长度为 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 引入新的转义符 "`"。可用让表名与关键词不冲突,同时不受限于上述表名称合法性约束检查,转义符不计入表名称的长度。 转义后的表(列)名同样受到长度限制要求,且长度计算的时候不计算转义符。使用转义字符以后,不再对转义字符中的内容进行大小写统一。 例如: \`aBc\` 和 \`abc\` 是不同的表(列)名,但是 abc 和 aBc 是相同的表(列)名。 +:::note 需要注意的是转义字符中的内容必须是可打印字符。 -支持版本 +::: + +### 支持版本 支持转义符的功能从 2.3.0.1 版本开始。 \ No newline at end of file