Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
taosdata
TDengine
提交
2f325d9e
T
TDengine
项目概览
taosdata
/
TDengine
1 年多 前同步成功
通知
1185
Star
22016
Fork
4786
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
1
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
T
TDengine
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
1
Issue
1
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
2f325d9e
编写于
4月 15, 2022
作者:
W
wade zhang
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
docs: refine some documents in advanced features, reference guide and operation guide
上级
1c6c24e1
变更
4
隐藏空白更改
内联
并排
Showing
4 changed file
with
35 addition
and
19 deletion
+35
-19
docs-cn/08-advance-feature/02-subscribe.mdx
docs-cn/08-advance-feature/02-subscribe.mdx
+1
-1
docs-cn/11-operation/09-status.md
docs-cn/11-operation/09-status.md
+19
-7
docs-cn/14-reference/01-taos-sql/08-interval.md
docs-cn/14-reference/01-taos-sql/08-interval.md
+5
-5
docs-cn/14-reference/01-taos-sql/09-limit.md
docs-cn/14-reference/01-taos-sql/09-limit.md
+10
-6
未找到文件。
docs-cn/08-advance-feature/02-subscribe.mdx
浏览文件 @
2f325d9e
...
@@ -14,7 +14,7 @@ import Node from "./_sub_node.mdx";
...
@@ -14,7 +14,7 @@ import Node from "./_sub_node.mdx";
import CSharp from "./_sub_cs.mdx";
import CSharp from "./_sub_cs.mdx";
import CDemo from "./_sub_c.mdx";
import CDemo from "./_sub_c.mdx";
基于数据天然的时间序列特性,TDengine 的数据写入(insert)与消息系统的数据发布(pub)逻辑上一致,均可视为系统中插入一条带时间戳的新记录。同时,TDengine 在内部严格按照数据时间序列单调递增的方式保存数据。本质上来说,TDengine 中
里
每一张表均可视为一个标准的消息队列。
基于数据天然的时间序列特性,TDengine 的数据写入(insert)与消息系统的数据发布(pub)逻辑上一致,均可视为系统中插入一条带时间戳的新记录。同时,TDengine 在内部严格按照数据时间序列单调递增的方式保存数据。本质上来说,TDengine 中每一张表均可视为一个标准的消息队列。
TDengine 内嵌支持轻量级的消息订阅与推送服务。使用系统提供的 API,用户可使用普通查询语句订阅数据库中的一张或多张表。订阅的逻辑和操作状态的维护均是由客户端完成,客户端定时轮询服务器是否有新的记录到达,有新的记录到达就会将结果反馈到客户。
TDengine 内嵌支持轻量级的消息订阅与推送服务。使用系统提供的 API,用户可使用普通查询语句订阅数据库中的一张或多张表。订阅的逻辑和操作状态的维护均是由客户端完成,客户端定时轮询服务器是否有新的记录到达,有新的记录到达就会将结果反馈到客户。
...
...
docs-cn/11-operation/09-status.md
浏览文件 @
2f325d9e
...
@@ -2,40 +2,52 @@
...
@@ -2,40 +2,52 @@
title
:
系统连接、任务查询管理
title
:
系统连接、任务查询管理
---
---
系统管理员可以从 CLI 查询系统的连接、正在进行的查询、流式计算,并且可以关闭连接、停止正在进行的查询和流式计算。CLI 里 SQL 语法如下:
系统管理员可以从 CLI 查询系统的连接、正在进行的查询、流式计算,并且可以关闭连接、停止正在进行的查询和流式计算。
## 显示数据库的连接
```
sql
```
sql
SHOW
CONNECTIONS
;
SHOW
CONNECTIONS
;
```
```
显示数据库的连接,其中一列显示 ip:port, 为连接的 IP 地址和端口号。
其结果中的一列显示 ip:port, 为连接的 IP 地址和端口号。
## 强制关闭数据库连接
```
sql
```
sql
KILL
CONNECTION
<
connection
-
id
>
;
KILL
CONNECTION
<
connection
-
id
>
;
```
```
强制关闭数据库连接,其中的 connection-id 是 SHOW CONNECTIONS 中显示的第一列的数字。
其中的 connection-id 是 SHOW CONNECTIONS 中显示的第一列的数字。
## 显示数据查询
```
sql
```
sql
SHOW
QUERIES
;
SHOW
QUERIES
;
```
```
显示数据查询,其中第一列显示的以冒号隔开的两个数字为 query-id,为发起该 query 应用连接的 connection-id 和查询次数。
其中第一列显示的以冒号隔开的两个数字为 query-id,为发起该 query 应用连接的 connection-id 和查询次数。
## 强制关闭数据查询
```
sql
```
sql
KILL
QUERY
<
query
-
id
>
;
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
```
sql
SHOW
STREAMS
;
SHOW
STREAMS
;
```
```
显示流式计算,其中第一列显示的以冒号隔开的两个数字为 stream-id, 为启动该 stream 应用连接的 connection-id 和发起 stream 的次数。
其中第一列显示的以冒号隔开的两个数字为 stream-id, 为启动该 stream 应用连接的 connection-id 和发起 stream 的次数。
## 强制关闭流式计算
```
sql
```
sql
KILL
STREAM
<
stream
-
id
>
;
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
浏览文件 @
2f325d9e
...
@@ -16,13 +16,13 @@ INTERVAL 子句用于产生相等时间周期的窗口,SLIDING 用以指定窗
...
@@ -16,13 +16,13 @@ INTERVAL 子句用于产生相等时间周期的窗口,SLIDING 用以指定窗
INTERVAL 和 SLIDING 子句需要配合聚合和选择函数来使用。以下 SQL 语句非法:
INTERVAL 和 SLIDING 子句需要配合聚合和选择函数来使用。以下 SQL 语句非法:
```
```
SELECT * FROM temp_t
able INTERVAL(1S)
SELECT * FROM temp_t
b_1 INTERVAL(1m);
```
```
SLIDING 的向前滑动的时间不能超过一个窗口的时间范围。以下语句非法:
SLIDING 的向前滑动的时间不能超过一个窗口的时间范围。以下语句非法:
```
```
SELECT COUNT(*) FROM temp_t
able INTERVAL(1D) SLIDING(2D)
SELECT COUNT(*) FROM temp_t
b_1 INTERVAL(1m) SLIDING(2m);
```
```
当 SLIDING 与 INTERVAL 取值相等的时候,滑动窗口即为翻转窗口。
当 SLIDING 与 INTERVAL 取值相等的时候,滑动窗口即为翻转窗口。
...
@@ -38,7 +38,7 @@ _ 从 2.1.5.0 版本开始,INTERVAL 语句允许的最短时间间隔调整为
...
@@ -38,7 +38,7 @@ _ 从 2.1.5.0 版本开始,INTERVAL 语句允许的最短时间间隔调整为
使用 STATE_WINDOW 来确定状态窗口划分的列。例如:
使用 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)
...
@@ -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
...
@@ -72,7 +72,7 @@ SELECT function_list FROM stb_name
```
```
-
在聚合查询中,function_list 位置允许使用聚合和选择函数,并要求每个函数仅输出单个结果(例如:COUNT、AVG、SUM、STDDEV、LEASTSQUARES、PERCENTILE、MIN、MAX、FIRST、LAST),而不能使用具有多行输出结果的函数(例如:DIFF 以及四则运算)。
-
在聚合查询中,function_list 位置允许使用聚合和选择函数,并要求每个函数仅输出单个结果(例如:COUNT、AVG、SUM、STDDEV、LEASTSQUARES、PERCENTILE、MIN、MAX、FIRST、LAST),而不能使用具有多行输出结果的函数(例如:DIFF 以及四则运算)。
-
此外
也
LAST_ROW 查询也不能与窗口聚合同时出现。
-
此外 LAST_ROW 查询也不能与窗口聚合同时出现。
-
标量函数(如:CEIL/FLOOR 等)也不能使用在窗口聚合查询中。
-
标量函数(如:CEIL/FLOOR 等)也不能使用在窗口聚合查询中。
-
-
...
...
docs-cn/14-reference/01-taos-sql/09-limit.md
浏览文件 @
2f325d9e
...
@@ -6,11 +6,12 @@ title: 边界限制
...
@@ -6,11 +6,12 @@ title: 边界限制
## 一般限制
## 一般限制
-
数据库名最大长度为 32。
-
数据库名最大长度为 32。
-
表名最大长度为 192,每行数据最大长度 16k 个字符, 从 2.1.7.0 版本开始,每行数据最大长度 48k 个字符(注意:数据行内每个 BINARY/NCHAR 类型的列还会额外占用 2 个字节的存储位置)。
-
表名最大长度为 192,不包括数据库名前缀和分隔符
-
列名最大长度为 64,最多允许 1024 列,最少需要 2 列,第一列必须是时间戳。(从 2.1.7.0 版本开始,改为最多允许 4096 列)
-
每行数据最大长度 16k 个字符, 从 2.1.7.0 版本开始,每行数据最大长度 48k 个字符(注意:数据行内每个 BINARY/NCHAR 类型的列还会额外占用 2 个字节的存储位置)。
-
列名最大长度为 64,最多允许 4096 列,最少需要 2 列,第一列必须是时间戳。注:从 2.1.7.0 版本(不含)以前最多允许 4096 列
-
标签名最大长度为 64,最多允许 128 个,可以 1 个,一个表中标签值的总长度不超过 16k 个字符。
-
标签名最大长度为 64,最多允许 128 个,可以 1 个,一个表中标签值的总长度不超过 16k 个字符。
-
SQL 语句最大长度 1048576 个字符,也可通过客户端配置参数 maxSQLLength 修改,取值范围 65480 ~ 1048576。
-
SQL 语句最大长度 1048576 个字符,也可通过客户端配置参数 maxSQLLength 修改,取值范围 65480 ~ 1048576。
-
SELECT 语句的查询结果,最多允许返回
1024 列(语句中的函数调用可能也会占用一些列空间),超限时需要显式指定较少的返回数据列,以避免语句执行报错。(从 2.1.7.0 版本开始,改为最多允许 4096 列)
-
SELECT 语句的查询结果,最多允许返回
4096 列(语句中的函数调用可能也会占用一些列空间),超限时需要显式指定较少的返回数据列,以避免语句执行报错。注: 2.1.7.0 版本(不含)之前为最多允许 1024 列
-
库的数目,超级表的数目、表的数目,系统不做限制,仅受系统资源限制。
-
库的数目,超级表的数目、表的数目,系统不做限制,仅受系统资源限制。
## GROUP BY 的限制
## GROUP BY 的限制
...
@@ -34,17 +35,20 @@ IS NOT NULL 支持所有类型的列。不为空的表达式为 <\>"",仅对
...
@@ -34,17 +35,20 @@ IS NOT NULL 支持所有类型的列。不为空的表达式为 <\>"",仅对
## 表(列)名合法性说明
## 表(列)名合法性说明
TDengine 中的表(列)名命名规则如下:
###
TDengine 中的表(列)名命名规则如下:
只能由字母、数字、下划线构成,数字不能在首位,长度不能超过 192 字节,不区分大小写。这里表名称不包括数据库名的前缀和分隔符。
只能由字母、数字、下划线构成,数字不能在首位,长度不能超过 192 字节,不区分大小写。这里表名称不包括数据库名的前缀和分隔符。
转移
后表(列)名规则:
### 转义
后表(列)名规则:
为了兼容支持更多形式的表(列)名,TDengine 引入新的转义符 "
`
"。可用让表名与关键词不冲突,同时不受限于上述表名称合法性约束检查,转义符不计入表名称的长度。
为了兼容支持更多形式的表(列)名,TDengine 引入新的转义符 "
`
"。可用让表名与关键词不冲突,同时不受限于上述表名称合法性约束检查,转义符不计入表名称的长度。
转义后的表(列)名同样受到长度限制要求,且长度计算的时候不计算转义符。使用转义字符以后,不再对转义字符中的内容进行大小写统一。
转义后的表(列)名同样受到长度限制要求,且长度计算的时候不计算转义符。使用转义字符以后,不再对转义字符中的内容进行大小写统一。
例如:
例如:
\`
aBc
\`
和
\`
abc
\`
是不同的表(列)名,但是 abc 和 aBc 是相同的表(列)名。
\`
aBc
\`
和
\`
abc
\`
是不同的表(列)名,但是 abc 和 aBc 是相同的表(列)名。
:::note
需要注意的是转义字符中的内容必须是可打印字符。
需要注意的是转义字符中的内容必须是可打印字符。
支持版本
:::
### 支持版本
支持转义符的功能从 2.3.0.1 版本开始。
支持转义符的功能从 2.3.0.1 版本开始。
\ No newline at end of file
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录