Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
taosdata
TDengine
提交
17822180
T
TDengine
项目概览
taosdata
/
TDengine
1 年多 前同步成功
通知
1187
Star
22018
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看板
提交
17822180
编写于
5月 31, 2022
作者:
G
gccgdb1234
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
docs: add histogram function
上级
c16d1f26
变更
2
显示空白变更内容
内联
并排
Showing
2 changed file
with
35 addition
and
33 deletion
+35
-33
docs-cn/12-taos-sql/07-function.md
docs-cn/12-taos-sql/07-function.md
+10
-10
docs-en/12-taos-sql/07-function.md
docs-en/12-taos-sql/07-function.md
+25
-23
未找到文件。
docs-cn/12-taos-sql/07-function.md
浏览文件 @
17822180
...
...
@@ -278,8 +278,8 @@ SELECT HISTOGRAM(field_name,bin_type, bin_description, normalized) FROM tb_nam
**适用于**
: 表和超级表。
**说明**
:
1.
bin_type 用户指定的分桶类型, 有效输入类型为"user_input“, ”linear_bin", "log_bin"。
2.
bin_description 描述如何生成分桶区间,针对三种桶类型,分别为以下描述格式(均为 JSON 格式字符串):
1.
bin_type 用户指定的分桶类型, 有效输入类型为"user_input“, ”linear_bin", "log_bin"。
2.
bin_description 描述如何生成分桶区间,针对三种桶类型,分别为以下描述格式(均为 JSON 格式字符串):
-
"user_input": "[1, 3, 5, 7]"
用户指定 bin 的具体数值。
...
...
@@ -290,12 +290,12 @@ SELECT HISTOGRAM(field_name,bin_type, bin_description, normalized) FROM tb_nam
-
"log_bin": "{"start":1.0, "factor": 2.0, "count": 5, "infinity": true}"
"start" 表示数据起始点,"factor" 表示按指数递增的因子,"count" 为 bin 的总数,"infinity" 表示是否添加(-inf, inf)作为区间起点跟终点,
生成区间为[-inf, 1.0, 2.0, 4.0, 8.0, 16.0, +inf]。
3.
normalized 是否将返回结果归一化到 0~1 之间 。有效输入为 0 和 1。
3.
normalized 是否将返回结果归一化到 0~1 之间 。有效输入为 0 和 1。
**示例**
:
```
sql
taos
>
SELECT
HISTOGRAM
(
voltage
,
"user_input"
,
"[1,3,5,7]"
,
1
)
FROM
meters
;
```
my
sql
taos> SELECT HISTOGRAM(voltage, "user_input", "[1,3,5,7]", 1) FROM meters;
histogram(voltage, "user_input", "[1,3,5,7]", 1) |
=======================================================
{"lower_bin":1, "upper_bin":3, "count":0.333333} |
...
...
@@ -303,7 +303,7 @@ SELECT HISTOGRAM(field_name,bin_type, bin_description, normalized) FROM tb_nam
{"lower_bin":5, "upper_bin":7, "count":0.333333} |
Query OK, 3 row(s) in set (0.004273s)
taos
>
SELECT
HISTOGRAM
(
voltage
,
'linear_bin'
,
'{"start": 1, "width": 3, "count": 3, "infinity": false}'
,
0
)
FROM
meters
;
taos> SELECT HISTOGRAM(voltage, 'linear_bin', '{"start": 1, "width": 3, "count": 3, "infinity": false}', 0) FROM meters;
histogram(voltage, 'linear_bin', '{"start": 1, "width": 3, " |
===================================================================
{"lower_bin":1, "upper_bin":4, "count":3} |
...
...
@@ -311,7 +311,7 @@ SELECT HISTOGRAM(field_name,bin_type, bin_description, normalized) FROM tb_nam
{"lower_bin":7, "upper_bin":10, "count":3} |
Query OK, 3 row(s) in set (0.004887s)
taos> SELECT HISTOGRAM(voltage, '
log_bin
', '
{
"start"
:
1
,
"factor"
:
3
,
"count"
:
3
,
"infinity"
:
true
}
', 0) FROM meters;
taos> SELECT HISTOGRAM(voltage, 'log_bin', '{"start": 1, "factor": 3, "count": 3, "infinity": true}', 0) FROM meters;
histogram(voltage, 'log_bin', '{"start": 1, "factor": 3, "count" |
===================================================================
{"lower_bin":-inf, "upper_bin":1, "count":3} |
...
...
docs-en/12-taos-sql/07-function.md
浏览文件 @
17822180
...
...
@@ -275,11 +275,12 @@ SELECT HISTOGRAM(field_name,bin_type, bin_description, normalized) FROM tb_nam
**Applicable table types**
: table, STable
**说明**
:
1.
bin_type: parameter to indicate the bucket type, valid inputs are: "user_input", "linear_bin", "log_bin"。
2.
bin_description: parameter to describe how to generate buckets,can be in the following JSON formats for each bin_type respectively:
-
"user_input": "[1, 3, 5, 7]"
User defined specified bin values.
**Explanations**
:
1.
bin_type: parameter to indicate the bucket type, valid inputs are: "user_input", "linear_bin", "log_bin"。
2.
bin_description: parameter to describe how to generate buckets,can be in the following JSON formats for each bin_type respectively:
- "user_input": "[1, 3, 5, 7]": User specified bin values.
- "linear_bin": "{"start": 0.0, "width": 5.0, "count": 5, "infinity": true}"
"start" - bin starting point.
...
...
@@ -294,12 +295,13 @@ SELECT HISTOGRAM(field_name,bin_type, bin_description, normalized) FROM tb_nam
"count" - number of bins generated.
"infinity" - whether to add(-inf, inf)as start/end point in generated range of bins.
The above "log_bin" descriptor generates a set of bins:[-inf, 1.0, 2.0, 4.0, 8.0, 16.0, +inf].
3. normalized: setting to 1/0 to turn on/off result normalization.
**示例**
:
3.
normalized: setting to 1/0 to turn on/off result normalization.
```
sql
taos
>
SELECT
HISTOGRAM
(
voltage
,
"user_input"
,
"[1,3,5,7]"
,
1
)
FROM
meters
;
**Example**
:
```
mysql
taos> SELECT HISTOGRAM(voltage, "user_input", "[1,3,5,7]", 1) FROM meters;
histogram(voltage, "user_input", "[1,3,5,7]", 1) |
=======================================================
{"lower_bin":1, "upper_bin":3, "count":0.333333} |
...
...
@@ -307,7 +309,7 @@ SELECT HISTOGRAM(field_name,bin_type, bin_description, normalized) FROM tb_nam
{"lower_bin":5, "upper_bin":7, "count":0.333333} |
Query OK, 3 row(s) in set (0.004273s)
taos
>
SELECT
HISTOGRAM
(
voltage
,
'linear_bin'
,
'{"start": 1, "width": 3, "count": 3, "infinity": false}'
,
0
)
FROM
meters
;
taos> SELECT HISTOGRAM(voltage, 'linear_bin', '{"start": 1, "width": 3, "count": 3, "infinity": false}', 0) FROM meters;
histogram(voltage, 'linear_bin', '{"start": 1, "width": 3, " |
===================================================================
{"lower_bin":1, "upper_bin":4, "count":3} |
...
...
@@ -315,7 +317,7 @@ SELECT HISTOGRAM(field_name,bin_type, bin_description, normalized) FROM tb_nam
{"lower_bin":7, "upper_bin":10, "count":3} |
Query OK, 3 row(s) in set (0.004887s)
taos> SELECT HISTOGRAM(voltage, '
log_bin
', '
{
"start"
:
1
,
"factor"
:
3
,
"count"
:
3
,
"infinity"
:
true
}
', 0) FROM meters;
taos> SELECT HISTOGRAM(voltage, 'log_bin', '{"start": 1, "factor": 3, "count": 3, "infinity": true}', 0) FROM meters;
histogram(voltage, 'log_bin', '{"start": 1, "factor": 3, "count" |
===================================================================
{"lower_bin":-inf, "upper_bin":1, "count":3} |
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录