Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
taosdata
TDengine
提交
59762947
T
TDengine
项目概览
taosdata
/
TDengine
大约 1 年 前同步成功
通知
1184
Star
22015
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看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
59762947
编写于
4月 02, 2022
作者:
W
wade zhang
提交者:
GitHub
4月 02, 2022
浏览文件
操作
浏览文件
下载
差异文件
Merge pull request #11211 from taosdata/docs/TD-13873-new
TD-13873: add CSUM, MAVG, SAMPLE functions in new version document
上级
c323744d
dc55d77a
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
183 addition
and
129 deletion
+183
-129
docs-cn/14-reference/01-taos-sql/07-function.md
docs-cn/14-reference/01-taos-sql/07-function.md
+183
-129
未找到文件。
docs-cn/14-reference/01-taos-sql/07-function.md
浏览文件 @
59762947
...
...
@@ -888,21 +888,75 @@ SELECT ROUND(field_name) FROM { tb_name | stb_name } [WHERE clause];
**功能说明**
:获得指定列的四舍五入的结果。
其他使用说明参见 CEIL 函数描述。
-
**ASIN**
### CSUM
```sql
SELECT CSUM(field_name) FROM { tb_name | stb_name } [WHERE clause]
```
**功能说明**
:累加和(Cumulative sum),输出行与输入行数相同。
**返回结果类型**
: 输入列如果是整数类型返回值为长整型 (int64_t),浮点数返回值为双精度浮点数(Double)。无符号整数类型返回值为无符号长整型(uint64_t)。 返回结果中同时带有每行记录对应的时间戳。
**适用数据类型**
:不能应用在 timestamp、binary、nchar、bool 类型字段上;在超级表查询中使用时,不能应用在标签之上。
**嵌套子查询支持**
: 适用于内层查询和外层查询。
**补充说明**
: 不支持 +、-、
*
、/ 运算,如 csum(col1) + csum(col2)。只能与聚合(Aggregation)函数一起使用。 该函数可以应用在普通表和超级表上。 使用在超级表上的时候,需要搭配 Group by tbname使用,将结果强制规约到单个时间线。
**支持版本**
: 从2.3.0.x开始支持
### MAVG
```sql
SELECT MAVG(field_name, K) FROM { tb_name | stb_name } [WHERE clause]
```
**功能说明**
: 计算连续 k 个值的移动平均数(moving average)。如果输入行数小于 k,则无结果输出。参数 k 的合法输入范围是 1≤ k ≤ 1000。
**返回结果类型**
: 返回双精度浮点数类型。
**适用数据类型**
: 不能应用在 timestamp、binary、nchar、bool 类型上;在超级表查询中使用时,不能应用在标签之上。
**嵌套子查询支持**
: 适用于内层查询和外层查询。
**补充说明**
: 不支持 +、-、
*
、/ 运算,如 mavg(col1, k1) + mavg(col2, k1); 只能与普通列,选择(Selection)、投影(Projection)函数一起使用,不能与聚合(Aggregation)函数一起使用;该函数可以应用在普通表和超级表上;使用在超级表上的时候,需要搭配 Group by tbname使用,将结果强制规约到单个时间线。
**支持版本**
: 从2.3.0.x开始支持
### SAMPLE
```sql
SELECT SAMPLE(field_name, K) FROM { tb_name | stb_name } [WHERE clause]
```
**功能说明**
: 获取数据的 k 个采样值。参数 k 的合法输入范围是 1≤ k ≤ 1000。
**返回结果类型**
: 同原始数据类型, 返回结果中带有该行记录的时间戳。
**适用数据类型**
: 在超级表查询中使用时,不能应用在标签之上。
**嵌套子查询支持**
: 适用于内层查询和外层查询。
**补充说明**
: 不能参与表达式计算;该函数可以应用在普通表和超级表上;使用在超级表上的时候,需要搭配 Group by tbname 使用,将结果强制规约到单个时间线。
**支持版本**
: 从2.3.0.x开始支持
### ASIN
```
sql
SELECT
ASIN
(
field_name
)
FROM
{
tb_name
|
stb_name
}
[
WHERE
clause
]
```
功能说明
:获得指定列的反正弦结果
**功能说明**
:获得指定列的反正弦结果
返回结果类型
:DOUBLE。如果输入值为 NULL,输出值也为 NULL
**返回结果类型**
:DOUBLE。如果输入值为 NULL,输出值也为 NULL
适用数据类型
:不能应用在 timestamp、binary、nchar、bool 类型字段上;在超级表查询中使用时,不能应用在 tag 列
**适用数据类型**
:不能应用在 timestamp、binary、nchar、bool 类型字段上;在超级表查询中使用时,不能应用在 tag 列
嵌套子查询支持
:适用于内层查询和外层查询。
**嵌套子查询支持**
:适用于内层查询和外层查询。
使用说明
:
**使用说明**
:
只能与普通列,选择(Selection)、投影(Projection)函数一起使用,不能与聚合(Aggregation)函数一起使用。
...
...
@@ -910,21 +964,21 @@ SELECT ROUND(field_name) FROM { tb_name | stb_name } [WHERE clause];
版本2.6.0.x后支持
-
**ACOS**
### ACOS
```
sql
SELECT
ACOS
(
field_name
)
FROM
{
tb_name
|
stb_name
}
[
WHERE
clause
]
```
功能说明
:获得指定列的反余弦结果
**功能说明**
:获得指定列的反余弦结果
返回结果类型
:DOUBLE。如果输入值为 NULL,输出值也为 NULL
**返回结果类型**
:DOUBLE。如果输入值为 NULL,输出值也为 NULL
适用数据类型
:不能应用在 timestamp、binary、nchar、bool 类型字段上;在超级表查询中使用时,不能应用在 tag 列
**适用数据类型**
:不能应用在 timestamp、binary、nchar、bool 类型字段上;在超级表查询中使用时,不能应用在 tag 列
嵌套子查询支持
:适用于内层查询和外层查询。
**嵌套子查询支持**
:适用于内层查询和外层查询。
使用说明
:
**使用说明**
:
只能与普通列,选择(Selection)、投影(Projection)函数一起使用,不能与聚合(Aggregation)函数一起使用。
...
...
@@ -932,21 +986,21 @@ SELECT ROUND(field_name) FROM { tb_name | stb_name } [WHERE clause];
版本2.6.0.x后支持
-
**ATAN**
### ATAN
```
sql
SELECT
ATAN
(
field_name
)
FROM
{
tb_name
|
stb_name
}
[
WHERE
clause
]
```
功能说明
:获得指定列的反正切结果
**功能说明**
:获得指定列的反正切结果
返回结果类型
:DOUBLE。如果输入值为 NULL,输出值也为 NULL
**返回结果类型**
:DOUBLE。如果输入值为 NULL,输出值也为 NULL
适用数据类型
:不能应用在 timestamp、binary、nchar、bool 类型字段上;在超级表查询中使用时,不能应用在 tag 列
**适用数据类型**
:不能应用在 timestamp、binary、nchar、bool 类型字段上;在超级表查询中使用时,不能应用在 tag 列
嵌套子查询支持
:适用于内层查询和外层查询。
**嵌套子查询支持**
:适用于内层查询和外层查询。
使用说明
:
**使用说明**
:
只能与普通列,选择(Selection)、投影(Projection)函数一起使用,不能与聚合(Aggregation)函数一起使用。
...
...
@@ -954,21 +1008,21 @@ SELECT ROUND(field_name) FROM { tb_name | stb_name } [WHERE clause];
版本2.6.0.x后支持
-
**SIN**
### SIN
```
sql
SELECT
SIN
(
field_name
)
FROM
{
tb_name
|
stb_name
}
[
WHERE
clause
]
```
功能说明
:获得指定列的正弦结果
**功能说明**
:获得指定列的正弦结果
返回结果类型
:DOUBLE。如果输入值为 NULL,输出值也为 NULL
**返回结果类型**
:DOUBLE。如果输入值为 NULL,输出值也为 NULL
适用数据类型
:不能应用在 timestamp、binary、nchar、bool 类型字段上;在超级表查询中使用时,不能应用在 tag 列
**适用数据类型**
:不能应用在 timestamp、binary、nchar、bool 类型字段上;在超级表查询中使用时,不能应用在 tag 列
嵌套子查询支持
:适用于内层查询和外层查询。
**嵌套子查询支持**
:适用于内层查询和外层查询。
使用说明
:
**使用说明**
:
只能与普通列,选择(Selection)、投影(Projection)函数一起使用,不能与聚合(Aggregation)函数一起使用。
...
...
@@ -976,21 +1030,21 @@ SELECT ROUND(field_name) FROM { tb_name | stb_name } [WHERE clause];
版本2.6.0.x后支持
-
**COS**
### COS
```
sql
SELECT
COS
(
field_name
)
FROM
{
tb_name
|
stb_name
}
[
WHERE
clause
]
```
功能说明
:获得指定列的余弦结果
**功能说明**
:获得指定列的余弦结果
返回结果类型
:DOUBLE。如果输入值为 NULL,输出值也为 NULL
**返回结果类型**
:DOUBLE。如果输入值为 NULL,输出值也为 NULL
适用数据类型
:不能应用在 timestamp、binary、nchar、bool 类型字段上;在超级表查询中使用时,不能应用在 tag 列
**适用数据类型**
:不能应用在 timestamp、binary、nchar、bool 类型字段上;在超级表查询中使用时,不能应用在 tag 列
嵌套子查询支持
:适用于内层查询和外层查询。
**嵌套子查询支持**
:适用于内层查询和外层查询。
使用说明
:
**使用说明**
:
只能与普通列,选择(Selection)、投影(Projection)函数一起使用,不能与聚合(Aggregation)函数一起使用。
...
...
@@ -998,21 +1052,21 @@ SELECT ROUND(field_name) FROM { tb_name | stb_name } [WHERE clause];
版本2.6.0.x后支持
-
**TAN**
### TAN
```
sql
SELECT
TAN
(
field_name
)
FROM
{
tb_name
|
stb_name
}
[
WHERE
clause
]
```
功能说明
:获得指定列的正切结果
**功能说明**
:获得指定列的正切结果
返回结果类型
:DOUBLE。如果输入值为 NULL,输出值也为 NULL
**返回结果类型**
:DOUBLE。如果输入值为 NULL,输出值也为 NULL
适用数据类型
:不能应用在 timestamp、binary、nchar、bool 类型字段上;在超级表查询中使用时,不能应用在 tag 列
**适用数据类型**
:不能应用在 timestamp、binary、nchar、bool 类型字段上;在超级表查询中使用时,不能应用在 tag 列
嵌套子查询支持
:适用于内层查询和外层查询。
**嵌套子查询支持**
:适用于内层查询和外层查询。
使用说明
:
**使用说明**
:
只能与普通列,选择(Selection)、投影(Projection)函数一起使用,不能与聚合(Aggregation)函数一起使用。
...
...
@@ -1020,21 +1074,21 @@ SELECT ROUND(field_name) FROM { tb_name | stb_name } [WHERE clause];
版本2.6.0.x后支持
-
**POW**
### POW
```
sql
SELECT
POW
(
field_name
,
power
)
FROM
{
tb_name
|
stb_name
}
[
WHERE
clause
]
```
功能说明
:获得指定列的指数为 power 的幂
**功能说明**
:获得指定列的指数为 power 的幂
返回结果类型
:DOUBLE。如果输入值为 NULL,输出值也为 NULL
**返回结果类型**
:DOUBLE。如果输入值为 NULL,输出值也为 NULL
适用数据类型
:不能应用在 timestamp、binary、nchar、bool 类型字段上;在超级表查询中使用时,不能应用在 tag 列
**适用数据类型**
:不能应用在 timestamp、binary、nchar、bool 类型字段上;在超级表查询中使用时,不能应用在 tag 列
嵌套子查询支持
:适用于内层查询和外层查询。
**嵌套子查询支持**
:适用于内层查询和外层查询。
使用说明
:
**使用说明**
:
只能与普通列,选择(Selection)、投影(Projection)函数一起使用,不能与聚合(Aggregation)函数一起使用。
...
...
@@ -1042,21 +1096,21 @@ SELECT ROUND(field_name) FROM { tb_name | stb_name } [WHERE clause];
版本2.6.0.x后支持
-
**LOG**
### LOG
```
sql
SELECT
LOG
(
field_name
,
base
)
FROM
{
tb_name
|
stb_name
}
[
WHERE
clause
]
```
功能说明
:获得指定列对于底数 base 的对数
**功能说明**
:获得指定列对于底数 base 的对数
返回结果类型
:DOUBLE。如果输入值为 NULL,输出值也为 NULL
**返回结果类型**
:DOUBLE。如果输入值为 NULL,输出值也为 NULL
适用数据类型
:不能应用在 timestamp、binary、nchar、bool 类型字段上;在超级表查询中使用时,不能应用在 tag 列
**适用数据类型**
:不能应用在 timestamp、binary、nchar、bool 类型字段上;在超级表查询中使用时,不能应用在 tag 列
嵌套子查询支持
:适用于内层查询和外层查询。
**嵌套子查询支持**
:适用于内层查询和外层查询。
使用说明
:
**使用说明**
:
只能与普通列,选择(Selection)、投影(Projection)函数一起使用,不能与聚合(Aggregation)函数一起使用。
...
...
@@ -1064,21 +1118,21 @@ SELECT ROUND(field_name) FROM { tb_name | stb_name } [WHERE clause];
版本2.6.0.x后支持
-
**ABS**
### ABS
```
sql
SELECT
ABS
(
field_name
)
FROM
{
tb_name
|
stb_name
}
[
WHERE
clause
]
```
功能说明
:获得指定列的绝对值
**功能说明**
:获得指定列的绝对值
返回结果类型
:如果输入值为整数,输出值是 UBIGINT 类型。如果输入值是 FLOAT/DOUBLE 数据类型,输出值是 DOUBLE 数据类型。
**返回结果类型**
:如果输入值为整数,输出值是 UBIGINT 类型。如果输入值是 FLOAT/DOUBLE 数据类型,输出值是 DOUBLE 数据类型。
适用数据类型
:不能应用在 timestamp、binary、nchar、bool 类型字段上;在超级表查询中使用时,不能应用在 tag 列
**适用数据类型**
:不能应用在 timestamp、binary、nchar、bool 类型字段上;在超级表查询中使用时,不能应用在 tag 列
嵌套子查询支持
:适用于内层查询和外层查询。
**嵌套子查询支持**
:适用于内层查询和外层查询。
使用说明
:
**使用说明**
:
只能与普通列,选择(Selection)、投影(Projection)函数一起使用,不能与聚合(Aggregation)函数一起使用。
...
...
@@ -1086,21 +1140,21 @@ SELECT ROUND(field_name) FROM { tb_name | stb_name } [WHERE clause];
版本2.6.0.x后支持
-
**SQRT**
### SQRT
```
sql
SELECT
SQRT
(
field_name
)
FROM
{
tb_name
|
stb_name
}
[
WHERE
clause
]
```
功能说明
:获得指定列的平方根
**功能说明**
:获得指定列的平方根
返回结果类型
:DOUBLE。如果输入值为 NULL,输出值也为 NULL
**返回结果类型**
:DOUBLE。如果输入值为 NULL,输出值也为 NULL
适用数据类型
:不能应用在 timestamp、binary、nchar、bool 类型字段上;在超级表查询中使用时,不能应用在 tag 列
**适用数据类型**
:不能应用在 timestamp、binary、nchar、bool 类型字段上;在超级表查询中使用时,不能应用在 tag 列
嵌套子查询支持
:适用于内层查询和外层查询。
**嵌套子查询支持**
:适用于内层查询和外层查询。
使用说明
:
**使用说明**
:
只能与普通列,选择(Selection)、投影(Projection)函数一起使用,不能与聚合(Aggregation)函数一起使用。
...
...
@@ -1108,17 +1162,17 @@ SELECT ROUND(field_name) FROM { tb_name | stb_name } [WHERE clause];
版本2.6.0.x后支持
-
**CAST**
### CAST
```
sql
SELECT
CAST
(
expression
AS
type_name
)
FROM
{
tb_name
|
stb_name
}
[
WHERE
clause
]
```
功能说明
:数据类型转换函数,输入参数 expression 支持普通列、常量、标量函数及它们之间的四则运算,不支持 tag 列,只适用于 select 子句中。
**功能说明**
:数据类型转换函数,输入参数 expression 支持普通列、常量、标量函数及它们之间的四则运算,不支持 tag 列,只适用于 select 子句中。
返回结果类型
:CAST 中指定的类型(type_name)。
**返回结果类型**
:CAST 中指定的类型(type_name)。
适用数据类型
:输入参数 expression 的类型可以是除 JSON 外目前所有类型字段(BOOL/TINYINT/SMALLINT/INT/BIGINT/FLOAT/DOUBLE/BINARY(M)/TIMESTAMP/NCHAR(M)/TINYINT UNSIGNED/SMALLINT UNSIGNED/INT UNSIGNED/BIGINT UNSIGNED); 输出目标类型只支持 BIGINT/BINARY(N)/TIMESTAMP/NCHAR(N)/BIGINT UNSIGNED。
**适用数据类型**
:输入参数 expression 的类型可以是除 JSON 外目前所有类型字段(BOOL/TINYINT/SMALLINT/INT/BIGINT/FLOAT/DOUBLE/BINARY(M)/TIMESTAMP/NCHAR(M)/TINYINT UNSIGNED/SMALLINT UNSIGNED/INT UNSIGNED/BIGINT UNSIGNED); 输出目标类型只支持 BIGINT/BINARY(N)/TIMESTAMP/NCHAR(N)/BIGINT UNSIGNED。
说明:
...
...
@@ -1133,19 +1187,19 @@ SELECT ROUND(field_name) FROM { tb_name | stb_name } [WHERE clause];
4)FLOAT/DOUBLE转BIGINT/BIGINT UNSIGNED可能遇到的溢出问题。
版本2.6.0.x后支持
-
**CONCAT**
### CONCAT
```
sql
SELECT
CONCAT
(
str1
|
column1
,
str2
|
column2
,
...)
FROM
{
tb_name
|
stb_name
}
[
WHERE
clause
]
```
功能说明
:字符串连接函数。
**功能说明**
:字符串连接函数。
返回结果类型
:同输入参数类型,BINARY 或者 NCHAR。
**返回结果类型**
:同输入参数类型,BINARY 或者 NCHAR。
适用数据类型
:输入参数或者全部是 BINARY 格式的字符串或者列,或者全部是 NCHAR 格式的字符串或者列。不能应用在 TAG 列。
**适用数据类型**
:输入参数或者全部是 BINARY 格式的字符串或者列,或者全部是 NCHAR 格式的字符串或者列。不能应用在 TAG 列。
说明
:
**说明**
:
如果输入值为NULL,输出值为NULL。
该函数最小参数个数为2个,最大参数个数为8个。
...
...
@@ -1153,19 +1207,19 @@ SELECT ROUND(field_name) FROM { tb_name | stb_name } [WHERE clause];
该函数适用于内层查询和外层查询。
版本2.6.0.x后支持
-
**CONCAT_WS**
### CONCAT_WS
```
SELECT CONCAT_WS(separator, str1|column1, str2|column2, ...) FROM { tb_name | stb_name } [WHERE clause]
```
功能说明
:带分隔符的字符串连接函数。
**功能说明**
:带分隔符的字符串连接函数。
返回结果类型
:同输入参数类型,BINARY 或者 NCHAR。
**返回结果类型**
:同输入参数类型,BINARY 或者 NCHAR。
适用数据类型
:输入参数或者全部是 BINARY 格式的字符串或者列,或者全部是 NCHAR 格式的字符串或者列。不能应用在 TAG 列。
**适用数据类型**
:输入参数或者全部是 BINARY 格式的字符串或者列,或者全部是 NCHAR 格式的字符串或者列。不能应用在 TAG 列。
说明
:
**说明**
:
如果separator值为NULL,输出值为NULL。如果separator值不为NULL,其他输入为NULL,输出为空串
该函数最小参数个数为3个,最大参数个数为9个。
...
...
@@ -1173,133 +1227,133 @@ SELECT ROUND(field_name) FROM { tb_name | stb_name } [WHERE clause];
该函数适用于内层查询和外层查询。
版本2.6.0.x后支持
-
**LENGTH**
### LENGTH
```
SELECT LENGTH(str|column) FROM { tb_name | stb_name } [WHERE clause]
```
功能说明
:以字节计数的字符串长度。
**功能说明**
:以字节计数的字符串长度。
返回结果类型
:INT。
**返回结果类型**
:INT。
适用数据类型
:输入参数是 BINARY 类型或者 NCHAR 类型的字符串或者列。不能应用在 TAG 列。
**适用数据类型**
:输入参数是 BINARY 类型或者 NCHAR 类型的字符串或者列。不能应用在 TAG 列。
说明:
**说明**
如果输入值为NULL,输出值为NULL。
该函数可以应用在普通表和超级表上。
该函数适用于内层查询和外层查询。
版本2.6.0.x后支持
-
**CHAR_LENGTH**
### CHAR_LENGTH
```
SELECT CHAR_LENGTH(str|column) FROM { tb_name | stb_name } [WHERE clause]
```
功能说明
:以字符计数的字符串长度。
**功能说明**
:以字符计数的字符串长度。
返回结果类型
:INT。
**返回结果类型**
:INT。
适用数据类型
:输入参数是 BINARY 类型或者 NCHAR 类型的字符串或者列。不能应用在 TAG 列。
**适用数据类型**
:输入参数是 BINARY 类型或者 NCHAR 类型的字符串或者列。不能应用在 TAG 列。
说明:
**说明**
如果输入值为NULL,输出值为NULL。
该函数可以应用在普通表和超级表上。
该函数适用于内层查询和外层查询。
版本2.6.0.x后支持
-
**LOWER**
### LOWER
```
SELECT LOWER(str|column) FROM { tb_name | stb_name } [WHERE clause]
```
功能说明
:将字符串参数值转换为全小写字母。
**功能说明**
:将字符串参数值转换为全小写字母。
返回结果类型
:同输入类型。
**返回结果类型**
:同输入类型。
适用数据类型
:输入参数是 BINARY 类型或者 NCHAR 类型的字符串或者列。不能应用在 TAG 列。
**适用数据类型**
:输入参数是 BINARY 类型或者 NCHAR 类型的字符串或者列。不能应用在 TAG 列。
说明
:
**说明**
:
如果输入值为NULL,输出值为NULL。
该函数可以应用在普通表和超级表上。
该函数适用于内层查询和外层查询。
版本2.6.0.x后支持
-
**UPPER**
### UPPER
```
SELECT UPPER(str|column) FROM { tb_name | stb_name } [WHERE clause]
```
功能说明
:将字符串参数值转换为全大写字母。
**功能说明**
:将字符串参数值转换为全大写字母。
返回结果类型
:同输入类型。
**返回结果类型**
:同输入类型。
适用数据类型
:输入参数是 BINARY 类型或者 NCHAR 类型的字符串或者列。不能应用在 TAG 列。
**适用数据类型**
:输入参数是 BINARY 类型或者 NCHAR 类型的字符串或者列。不能应用在 TAG 列。
说明
:
**说明**
:
如果输入值为NULL,输出值为NULL。
该函数可以应用在普通表和超级表上。
该函数适用于内层查询和外层查询。
版本2.6.0.x后支持
-
**LTRIM**
### LTRIM
```
SELECT LTRIM(str|column) FROM { tb_name | stb_name } [WHERE clause]
```
功能说明
:返回清除左边空格后的字符串。
**功能说明**
:返回清除左边空格后的字符串。
返回结果类型
:同输入类型。
**返回结果类型**
:同输入类型。
适用数据类型
:输入参数是 BINARY 类型或者 NCHAR 类型的字符串或者列。不能应用在 TAG 列。
**适用数据类型**
:输入参数是 BINARY 类型或者 NCHAR 类型的字符串或者列。不能应用在 TAG 列。
说明
:
**说明**
:
如果输入值为NULL,输出值为NULL。
该函数可以应用在普通表和超级表上。
该函数适用于内层查询和外层查询。
版本2.6.0.x后支持
-
**RTRIM**
### RTRIM
```
SELECT RTRIM(str|column) FROM { tb_name | stb_name } [WHERE clause]
```
功能说明
:返回清除右边空格后的字符串。
**功能说明**
:返回清除右边空格后的字符串。
返回结果类型
:同输入类型。
**返回结果类型**
:同输入类型。
适用数据类型
:输入参数是 BINARY 类型或者 NCHAR 类型的字符串或者列。不能应用在 TAG 列。
**适用数据类型**
:输入参数是 BINARY 类型或者 NCHAR 类型的字符串或者列。不能应用在 TAG 列。
说明
:
**说明**
:
如果输入值为NULL,输出值为NULL。
该函数可以应用在普通表和超级表上。
该函数适用于内层查询和外层查询。
版本2.6.0.x后支持
-
**SUBSTR**
### SUBSTR
```
SELECT SUBSTR(str,pos[,len]) FROM { tb_name | stb_name } [WHERE clause]
```
功能说明
:从源字符串 str 中的指定位置 pos 开始取一个长度为 len 的子串并返回。
**功能说明**
:从源字符串 str 中的指定位置 pos 开始取一个长度为 len 的子串并返回。
返回结果类型
:同输入类型。
**返回结果类型**
:同输入类型。
适用数据类型
:输入参数是 BINARY 类型或者 NCHAR 类型的字符串或者列。不能应用在 TAG 列。
**适用数据类型**
:输入参数是 BINARY 类型或者 NCHAR 类型的字符串或者列。不能应用在 TAG 列。
说明
:
**说明**
:
如果输入值为NULL,输出值为NULL。
输入参数pos可以为正数,也可以为负数。如果pos是正数,表示开始位置从字符串开头正数计算。如果pos为负数,表示开始位置从字符串结尾倒数计算。如果输入参数len被忽略,返回的子串包含从pos开始的整个字串。
...
...
@@ -1321,7 +1375,7 @@ SELECT field_name [+|-|*|/|%][Value|field_name] FROM { tb_name | stb_name } [WH
**适用于**
:表、超级表。
说明
:
**说明**
:
1)支持两列或多列之间进行计算,可使用括号控制计算优先级;
...
...
@@ -1364,7 +1418,7 @@ SELECT STATECOUNT(field_name, oper, val) FROM { tb_name | stb_name } [WHERE clau
-
不能和窗口操作一起使用,例如 interval/state_window/session_window。
示例
:
**示例**
:
```
taos> select ts,dbig from statef2;
...
...
@@ -1418,7 +1472,7 @@ SELECT stateDuration(field_name, oper, val, unit) FROM { tb_name | stb_name } [W
-
不能和窗口操作一起使用,例如 interval/state_window/session_window。
示例
:
**示例**
:
```
taos> select ts,dbig from statef2;
...
...
@@ -1444,7 +1498,7 @@ ts | dbig | stateduration(dbig,gt,2) |
Query OK, 6 row(s) in set (0.002613s)
```
##
#
时间函数
## 时间函数
从 2.6.0.0 版本开始,TDengine 查询引擎支持以下时间相关函数:
...
...
@@ -1469,7 +1523,7 @@ INSERT INTO tb_name VALUES (NOW(), ...);
b(纳秒)、u(微秒)、a(毫秒)、s(秒)、m(分)、h(小时)、d(天)、w(周)。
2)返回的时间戳精度与当前 DATABASE 设置的时间精度一致。
示例
:
**示例**
:
```
sql
taos
>
SELECT
NOW
()
FROM
meters
;
...
...
@@ -1494,7 +1548,7 @@ taos> INSERT INTO d1001 VALUES (NOW(), 10.2, 219, 0.32);
Query
OK
,
1
of
1
row
(
s
)
in
database
(
0
.
002210
s
)
```
## TODAY
##
#
TODAY
```
sql
SELECT
TODAY
()
FROM
{
tb_name
|
stb_name
}
[
WHERE
clause
];
...
...
@@ -1515,7 +1569,7 @@ INSERT INTO tb_name VALUES (TODAY(), ...);
b(纳秒),u(微秒),a(毫秒),s(秒),m(分),h(小时),d(天),w(周)。
2)返回的时间戳精度与当前 DATABASE 设置的时间精度一致。
示例
:
**示例**
:
```
sql
taos
>
SELECT
TODAY
()
FROM
meters
;
...
...
@@ -1540,7 +1594,7 @@ taos> INSERT INTO d1001 VALUES (TODAY(), 10.2, 219, 0.32);
Query
OK
,
1
of
1
row
(
s
)
in
database
(
0
.
002210
s
)
```
## TIMEZONE
##
#
TIMEZONE
```
sql
SELECT
TIMEZONE
()
FROM
{
tb_name
|
stb_name
}
[
WHERE
clause
];
...
...
@@ -1554,7 +1608,7 @@ SELECT TIMEZONE() FROM { tb_name | stb_name } [WHERE clause];
**适用于**
:表、超级表。
示例
:
**示例**
:
```
sql
taos
>
SELECT
TIMEZONE
()
FROM
meters
;
...
...
@@ -1564,7 +1618,7 @@ taos> SELECT TIMEZONE() FROM meters;
Query
OK
,
1
row
(
s
)
in
set
(
0
.
002093
s
)
```
## TO_ISO8601
##
#
TO_ISO8601
```
sql
SELECT
TO_ISO8601
(
ts_val
|
ts_col
)
FROM
{
tb_name
|
stb_name
}
[
WHERE
clause
];
...
...
@@ -1580,7 +1634,7 @@ SELECT TO_ISO8601(ts_val | ts_col) FROM { tb_name | stb_name } [WHERE clause];
**说明**
:如果输入是 UNIX 时间戳常量,返回格式精度由时间戳的位数决定,如果输入是 TIMSTAMP 类型的列,返回格式的时间戳精度与当前 DATABASE 设置的时间精度一致。
示例
:
**示例**
:
```
sql
taos
>
SELECT
TO_ISO8601
(
1643738400
)
FROM
meters
;
...
...
@@ -1596,7 +1650,7 @@ taos> SELECT TO_ISO8601(ts) FROM meters;
2022
-
02
-
02
T02
:
00
:
00
+
0800
|
```
## TO_UNIXTIMESTAMP
##
#
TO_UNIXTIMESTAMP
```
sql
SELECT
TO_UNIXTIMESTAMP
(
datetime_string
|
ts_col
)
FROM
{
tb_name
|
stb_name
}
[
WHERE
clause
];
...
...
@@ -1610,11 +1664,11 @@ SELECT TO_UNIXTIMESTAMP(datetime_string | ts_col) FROM { tb_name | stb_name } [W
**适用于**
:表、超级表。
说明
:
**说明**
:
1)输入的日期时间字符串须符合 ISO8601/RFC3339 标准,无法转换的字符串格式将返回 0。
2)返回的时间戳精度与当前 DATABASE 设置的时间精度一致。
示例
:
**示例**
:
```
sql
taos
>
SELECT
TO_UNIXTIMESTAMP
(
"2022-02-02T02:00:00.000Z"
)
FROM
meters
;
...
...
@@ -1630,7 +1684,7 @@ taos> SELECT TO_UNIXTIMESTAMP(col_binary) FROM meters;
1643767200000
|
```
## TIMETRUNCATE
##
#
TIMETRUNCATE
```
sql
SELECT
TIMETRUNCATE
(
ts_val
|
datetime_string
|
ts_col
,
time_unit
)
FROM
{
tb_name
|
stb_name
}
[
WHERE
clause
];
...
...
@@ -1644,12 +1698,12 @@ SELECT TIMETRUNCATE(ts_val | datetime_string | ts_col, time_unit) FROM { tb_name
**适用于**
:表、超级表。
说明
:
**说明**
:
1)支持的时间单位 time_unit 如下:
1u(微秒),1a(毫秒),1s(秒),1m(分),1h(小时),1d(天)。
2)返回的时间戳精度与当前 DATABASE 设置的时间精度一致。
示例
:
**示例**
:
```
sql
taos
>
SELECT
TIMETRUNCATE
(
1643738522000
,
1
h
)
FROM
meters
;
...
...
@@ -1673,7 +1727,7 @@ taos> SELECT TIMETRUNCATE(ts, 1h) FROM meters;
Query
OK
,
3
row
(
s
)
in
set
(
0
.
003903
s
)
```
## TIMEDIFF
##
#
TIMEDIFF
```
sql
SELECT
TIMEDIFF
(
ts_val1
|
datetime_string1
|
ts_col1
,
ts_val2
|
datetime_string2
|
ts_col2
[,
time_unit
])
FROM
{
tb_name
|
stb_name
}
[
WHERE
clause
];
...
...
@@ -1687,12 +1741,12 @@ SELECT TIMEDIFF(ts_val1 | datetime_string1 | ts_col1, ts_val2 | datetime_string2
**适用于**
:表、超级表。
说明
:
**说明**
:
1)支持的时间单位 time_unit 如下:
1u(微秒),1a(毫秒),1s(秒),1m(分),1h(小时),1d(天)。
2)如果时间单位 time_unit 未指定, 返回的时间差值精度与当前 DATABASE 设置的时间精度一致。
示例
:
**示例**
:
```
sql
taos
>
SELECT
TIMEDIFF
(
1643738400000
,
1643742000000
)
FROM
meters
;
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录