TAOS SQL - SQL 函数 - 《TDengine v2.0 数据库文档》

COUNT

功能说明：统计表/超级表中记录行数或某列的非空值个数。

返回结果数据类型：长整型INT64。

应用字段：应用全部字段。

适用于：表、超级表。

说明：

1）可以使用星号来替代具体的字段，使用星号()返回全部记录数量。

2）针对同一表的（不包含NULL值）字段查询结果均相同。

3）如果统计对象是具体的列，则返回该列中非NULL值的记录数量。

示例：


    count(*)        |    count(voltage)     |
================================================
                    9 |                     9 |
Query OK, 1 row(s) in set (0.004475s)
taos> SELECT COUNT(*), COUNT(voltage) FROM d1001;
    count(*)        |    count(voltage)     |
================================================
                    3 |                     3 |
Query OK, 1 row(s) in set (0.001075s)

AVG

SELECT AVG(field_name) FROM tb_name [WHERE clause];

功能说明：统计表/超级表中某列的平均值。

返回结果数据类型：双精度浮点数Double。

应用字段：不能应用在timestamp、binary、nchar、bool字段。

适用于：表、超级表。

示例：

taos> SELECT AVG(current), AVG(voltage), AVG(phase) FROM meters;
    avg(current)        |       avg(voltage)        |        avg(phase)         |
====================================================================================
            11.466666751 |             220.444444444 |               0.293333333 |
Query OK, 1 row(s) in set (0.004135s)
taos> SELECT AVG(current), AVG(voltage), AVG(phase) FROM d1001;
    avg(current)        |       avg(voltage)        |        avg(phase)         |
====================================================================================
            11.733333588 |             219.333333333 |               0.316666673 |
Query OK, 1 row(s) in set (0.000943s)

TWA
```
SELECT TWA(field_name) FROM tb_name WHERE clause;
```
功能说明：时间加权平均函数。统计表中某列在一段时间内的时间加权平均。

返回结果数据类型：双精度浮点数Double。

应用字段：不能应用在timestamp、binary、nchar、bool类型字段。

适用于：表。

SUM

SELECT SUM(field_name) FROM tb_name [WHERE clause];

功能说明：统计表/超级表中某列的和。

返回结果数据类型：双精度浮点数Double和长整型INT64。

应用字段：不能应用在timestamp、binary、nchar、bool类型字段。

适用于：表、超级表。

示例：

taos> SELECT SUM(current), SUM(voltage), SUM(phase) FROM meters;
    sum(current)        |     sum(voltage)      |        sum(phase)         |
================================================================================
            103.200000763 |                  1984 |               2.640000001 |
Query OK, 1 row(s) in set (0.001702s)
taos> SELECT SUM(current), SUM(voltage), SUM(phase) FROM d1001;
    sum(current)        |     sum(voltage)      |        sum(phase)         |
================================================================================
            35.200000763 |                   658 |               0.950000018 |
Query OK, 1 row(s) in set (0.000980s)

STDDEV
```
SELECT STDDEV(field_name) FROM tb_name [WHERE clause];
```
功能说明：统计表中某列的均方差。

返回结果数据类型：双精度浮点数Double。

应用字段：不能应用在timestamp、binary、nchar、bool类型字段。

适用于：表。（从 2.0.15.1 版本开始，本函数也支持超级表）

示例：
```
taos> SELECT STDDEV(current) FROM d1001;
    stddev(current)      |
============================
            1.020892909 |
Query OK, 1 row(s) in set (0.000915s)
```
LEASTSQUARES
```
SELECT LEASTSQUARES(field_name, start_val, step_val) FROM tb_name [WHERE clause];
```
功能说明：统计表中某列的值是主键（时间戳）的拟合直线方程。start_val是自变量初始值，step_val是自变量的步长值。

返回结果数据类型：字符串表达式（斜率, 截距）。

应用字段：不能应用在timestamp、binary、nchar、bool类型字段。

说明：自变量是时间戳，因变量是该列的值。

适用于：表。
```
taos> SELECT LEASTSQUARES(current, 1, 1) FROM d1001;
            leastsquares(current, 1, 1)             |
=====================================================
{slop:1.000000, intercept:9.733334}                 |
Query OK, 1 row(s) in set (0.000921s)
```

MIN

功能说明：统计表/超级表中某列的值最小值。

返回结果数据类型：同应用的字段。

应用字段：不能应用在timestamp、binary、nchar、bool类型字段。

示例：

taos> SELECT MIN(current), MIN(voltage) FROM meters;
    min(current)     | min(voltage) |
            10.20000 |          218 |
Query OK, 1 row(s) in set (0.001765s)
    min(current)     | min(voltage) |
======================================
            10.30000 |          218 |
Query OK, 1 row(s) in set (0.000950s)

MAX

SELECT MAX(field_name) FROM { tb_name | stb_name } [WHERE clause];

功能说明：统计表/超级表中某列的值最大值。

返回结果数据类型：同应用的字段。

应用字段：不能应用在timestamp、binary、nchar、bool类型字段。

示例：

taos> SELECT MAX(current), MAX(voltage) FROM meters;
    max(current)     | max(voltage) |
======================================
            13.40000 |          223 |
Query OK, 1 row(s) in set (0.001123s)
taos> SELECT MAX(current), MAX(voltage) FROM d1001;
    max(current)     | max(voltage) |
======================================
            12.60000 |          221 |
Query OK, 1 row(s) in set (0.000987s)

FIRST

SELECT FIRST(field_name) FROM { tb_name | stb_name } [WHERE clause];

功能说明：统计表/超级表中某列的值最先写入的非NULL值。

返回结果数据类型：同应用的字段。

应用字段：所有字段。

说明：

1）如果要返回各个列的首个（时间戳最小）非NULL值，可以使用FIRST(*)；

2) 如果结果集中的某列全部为NULL值，则该列的返回结果也是NULL；

3) 如果结果集中所有列全部为NULL值，则不返回结果。

示例：

taos> SELECT FIRST(*) FROM meters;
        first(ts)        |    first(current)    | first(voltage) |     first(phase)     |
=========================================================================================
2018-10-03 14:38:04.000 |             10.20000 |            220 |              0.23000 |
Query OK, 1 row(s) in set (0.004767s)
taos> SELECT FIRST(current) FROM d1002;
    first(current)    |
=======================
            10.20000 |
Query OK, 1 row(s) in set (0.001023s)

LAST

SELECT LAST(field_name) FROM { tb_name | stb_name } [WHERE clause];

功能说明：统计表/超级表中某列的值最后写入的非NULL值。

返回结果数据类型：同应用的字段。

应用字段：所有字段。

说明：

1）如果要返回各个列的最后（时间戳最大）一个非NULL值，可以使用LAST(*)；

2）如果结果集中的某列全部为NULL值，则该列的返回结果也是NULL；如果结果集中所有列全部为NULL值，则不返回结果。

示例：

taos> SELECT LAST(*) FROM meters;
        last(ts)         |    last(current)     | last(voltage) |     last(phase)      |
========================================================================================
2018-10-03 14:38:16.800 |             12.30000 |           221 |              0.31000 |
Query OK, 1 row(s) in set (0.001452s)
taos> SELECT LAST(current) FROM d1002;
    last(current)     |
=======================
            10.30000 |
Query OK, 1 row(s) in set (0.000843s)

TOP

SELECT TOP(field_name, K) FROM { tb_name | stb_name } [WHERE clause];

功能说明：统计表/超级表中某列的值最大k个非NULL值。若多于k个列值并列最大，则返回时间戳小的。

返回结果数据类型：同应用的字段。

应用字段：不能应用在timestamp、binary、nchar、bool类型字段。

说明：

1）k值取值范围1≤k≤100；

2）系统同时返回该记录关联的时间戳列。

示例：

taos> SELECT TOP(current, 3) FROM meters;
        ts            |   top(current, 3)    |
=================================================
2018-10-03 14:38:15.000 |             12.60000 |
2018-10-03 14:38:16.600 |             13.40000 |
2018-10-03 14:38:16.800 |             12.30000 |
Query OK, 3 row(s) in set (0.001548s)
taos> SELECT TOP(current, 2) FROM d1001;
        ts            |   top(current, 2)    |
=================================================
Query OK, 2 row(s) in set (0.000810s)

BOTTOM
```
SELECT BOTTOM(field_name, K) FROM { tb_name | stb_name } [WHERE clause];
```
功能说明：统计表/超级表中某列的值最小k个非NULL值。若多于k个列值并列最小，则返回时间戳小的。

返回结果数据类型：同应用的字段。

应用字段：不能应用在timestamp、binary、nchar、bool类型字段。

1）k值取值范围1≤k≤100；

2）系统同时返回该记录关联的时间戳列。

示例：
PERCENTILE
```
SELECT PERCENTILE(field_name, P) FROM { tb_name } [WHERE clause];
```
功能说明：统计表中某列的值百分比分位数。

返回结果数据类型：双精度浮点数Double。

应用字段：不能应用在timestamp、binary、nchar、bool类型字段。

说明：P值取值范围0≤P≤100，为0的时候等同于MIN，为100的时候等同于MAX。

示例：
```
taos> SELECT PERCENTILE(current, 20) FROM d1001;
percentile(current, 20)  |
============================
            11.100000191 |
Query OK, 1 row(s) in set (0.000787s)
```
APERCENTILE
```
SELECT APERCENTILE(field_name, P) FROM { tb_name | stb_name } [WHERE clause];
```
功能说明：统计表中某列的值百分比分位数，与PERCENTILE函数相似，但是返回近似结果。

返回结果数据类型：双精度浮点数Double。

应用字段：不能应用在timestamp、binary、nchar、bool类型字段。

说明：P值取值范围0≤P≤100，为0的时候等同于MIN，为100的时候等同于MAX。推荐使用APERCENTILE函数，该函数性能远胜于PERCENTILE函数
```
taos> SELECT APERCENTILE(current, 20) FROM d1001;
apercentile(current, 20)  |
============================
            10.300000191 |
Query OK, 1 row(s) in set (0.000645s)
```

LAST_ROW

SELECT LAST_ROW(field_name) FROM { tb_name | stb_name };

功能说明：返回表（超级表）的最后一条记录。

返回结果数据类型：同应用的字段。

应用字段：所有字段。

说明：与last函数不同，last_row不支持时间范围限制，强制返回最后一条记录。

示例：

taos> SELECT LAST_ROW(current) FROM meters;
last_row(current)   |
=======================
            12.30000 |
Query OK, 1 row(s) in set (0.001238s)
taos> SELECT LAST_ROW(current) FROM d1002;
last_row(current)   |
=======================
            10.30000 |
Query OK, 1 row(s) in set (0.001042s)

DIFF

SELECT DIFF(field_name) FROM tb_name [WHERE clause];

功能说明：统计表中某列的值与前一行对应值的差。

返回结果数据类型：同应用字段。

应用字段：不能应用在timestamp、binary、nchar、bool类型字段。

说明：输出结果行数是范围内总行数减一，第一行没有结果输出。

示例：

taos> SELECT DIFF(current) FROM d1001;
        ts            |    diff(current)     |
=================================================
2018-10-03 14:38:15.000 |              2.30000 |
2018-10-03 14:38:16.800 |             -0.30000 |
Query OK, 2 row(s) in set (0.001162s)

SPREAD

SELECT SPREAD(field_name) FROM { tb_name | stb_name } [WHERE clause];

功能说明：统计表/超级表中某列的最大值和最小值之差。

返回结果数据类型：双精度浮点数。

应用字段：不能应用在binary、nchar、bool类型字段。

说明：可用于TIMESTAMP字段，此时表示记录的时间覆盖范围。

示例：

taos> SELECT SPREAD(voltage) FROM meters;
    spread(voltage)      |
============================
            5.000000000 |
Query OK, 1 row(s) in set (0.001792s)
taos> SELECT SPREAD(voltage) FROM d1001;
    spread(voltage)      |
============================
            3.000000000 |
Query OK, 1 row(s) in set (0.000836s)

四则运算

功能说明：统计表/超级表中某列或多列间的值加、减、乘、除、取余计算结果。

返回结果数据类型：双精度浮点数。

应用字段：不能应用在timestamp、binary、nchar、bool类型字段。

说明：

1）支持两列或多列之间进行计算，可使用括号控制计算优先级；

2）NULL字段不参与计算，如果参与计算的某行中包含NULL，该行的计算结果为NULL。
```
taos> SELECT current + voltage * phase FROM d1001;
(current+(voltage*phase)) |
============================
            78.190000713 |
            84.540003240 |
            80.810000718 |
```