当前位置：首页 > news >正文

TDengine函数大全-选择函数

news 2025/7/4 15:38:51

以下内容来自 TDengine 官方文档及
GitHub 内容。

以下所有示例基于 TDengine 3.1.0.3

TDengine函数大全

1.数学函数
2.字符串函数
3.转换函数
4.时间和日期函数
5.聚合函数
6.选择函数
7.时序数据库特有函数
8.系统函数

选择函数

- TDengine函数大全
- - BOTTOM
  - FIRST
  - INTERP
  - LAST
  - LAST_ROW
  - MAX
  - MIN
  - MODE
  - SAMPLE
  - TAIL
  - TOP
  - UNIQUE

BOTTOM

BOTTOM(expr, k)

功能说明：统计表/超级表中某列的值最小 k 个非 NULL 值。如果多条数据取值一样，全部取用又会超出 k 条限制时，系统会从相同值中随机选取符合要求的数量返回。

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

适用数据类型：数值类型。

适用于：表和超级表。

使用说明:

k值取值范围 1≤k≤100；
限制：BOTTOM 函数不支持 FILL 子句。

示例:

> select * from t7;ts            |     v1      |
========================================2023-08-01 01:01:01.000 |           1 |2023-08-01 01:01:02.000 |           2 |2023-08-01 01:01:03.000 |           3 |2023-08-01 01:01:04.000 |           4 |2023-08-01 01:01:05.000 |           5 |2023-08-01 01:01:06.000 |           6 |2023-08-01 01:01:07.000 |           7 |2023-08-01 01:01:08.000 |           8 |2023-08-01 01:01:09.000 |           9 |2023-08-01 01:01:10.000 |          10 |> select bottom(v1,2) from t7;bottom(v1,2) |
===============2 |1 |> select ts,bottom(v1,2) from t7;ts            | bottom(v1,2) |
=========================================2023-08-01 01:01:02.000 |            2 |2023-08-01 01:01:01.000 |            1 |> select ts,bottom(v1,3) from t7;ts            | bottom(v1,3) |
=========================================2023-08-01 01:01:03.000 |            3 |2023-08-01 01:01:01.000 |            1 |2023-08-01 01:01:02.000 |            2 |

FIRST

FIRST(expr)

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

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

适用数据类型：所有字段。

适用于：表和超级表。

使用说明:

如果要返回各个列的首个（时间戳最小）非 NULL 值，可以使用 FIRST(*)；
如果结果集中的某列全部为 NULL 值，则该列的返回结果也是 NULL；
如果结果集中所有列全部为 NULL 值，则不返回结果。

示例:

> select * from t7;ts            |     v1      |     v2      |
======================================================2023-08-01 01:01:00.000 | NULL        | NULL        |2023-08-01 01:01:01.000 |           1 | NULL        |2023-08-01 01:01:02.000 |           2 | NULL        |2023-08-01 01:01:03.000 |           3 | NULL        |2023-08-01 01:01:04.000 |           4 | NULL        |2023-08-01 01:01:05.000 |           5 | NULL        |2023-08-01 01:01:06.000 |           6 | NULL        |2023-08-01 01:01:07.000 |           7 | NULL        |2023-08-01 01:01:08.000 |           8 | NULL        |2023-08-01 01:01:09.000 |           9 | NULL        |2023-08-01 01:01:10.000 |          10 | NULL        |> select first(*) from t7;first(ts)        |  first(v1)  |  first(v2)  |
======================================================2023-08-01 01:01:00.000 |           1 | NULL        |> select first(v1) from t7;first(v1)  |
==============1 |> select ts,first(v1) from t7;ts            |  first(v1)  |
========================================2023-08-01 01:01:01.000 |           1 |> select ts,first(v2) from t7;
Query OK, 0 row(s) in set (0.001117s)

INTERP

INTERP(expr [, ignore_null_values])ignore_null_values: {0| 1
}

功能说明：返回指定时间截面指定列的记录值或插值。ignore_null_values 参数的值可以是 0 或 1，为 1 时表示忽略 NULL 值, 缺省值为0。

返回数据类型：同字段类型。

适用数据类型：数值类型。

适用于：表和超级表。

使用说明

INTERP 用于在指定时间断面获取指定列的记录值，如果该时间断面不存在符合条件的行数据，那么会根据 FILL 参数的设定进行插值。
INTERP 的输入数据为指定列的数据，可以通过条件语句（where 子句）来对原始列数据进行过滤，如果没有指定过滤条件则输入为全部数据。
INTERP 需要同时与 RANGE，EVERY 和 FILL 关键字一起使用。
INTERP 的输出时间范围根据 RANGE(timestamp1, timestamp2)字段来指定，需满足 timestamp1 <= timestamp2。其中 timestamp1 为输出时间范围的起始值，即如果 timestamp1 时刻符合插值条件则 timestamp1 为输出的第一条记录，timestamp2 为输出时间范围的结束值，即输出的最后一条记录的 timestamp 不能大于 timestamp2。
INTERP 根据 EVERY(time_unit) 字段来确定输出时间范围内的结果条数，即从 timestamp1 开始每隔固定长度的时间（time_unit 值）进行插值，time_unit 可取值时间单位：1a(毫秒)，1s(秒)，1m(分)，1h(小时)，1d(天)，1w(周)。例如 EVERY(500a) 将对于指定数据每500毫秒间隔进行一次插值.
INTERP 根据 FILL 字段来决定在每个符合输出条件的时刻如何进行插值。
INTERP 可以在 RANGE 字段中只指定唯一的时间戳对单个时间点进行插值，在这种情况下，EVERY 字段可以省略。例如：SELECT INTERP(col) FROM tb RANGE(‘2023-01-01 00:00:00’) FILL(linear).
INTERP 作用于超级表时, 会将该超级表下的所有子表数据按照主键列排序后进行插值计算，也可以搭配 PARTITION BY tbname 使用，将结果强制规约到单个时间线。
INTERP 可以与伪列 _irowts 一起使用，返回插值点所对应的时间戳(3.0.2.0版本以后支持)。
INTERP 可以与伪列 _isfilled 一起使用，显示返回结果是否为原始记录或插值算法产生的数据(3.0.3.0版本以后支持)。

示例:

> select * from t7;ts            |     v1      |     v2      |
======================================================2023-08-01 01:01:00.000 | NULL        | NULL        |2023-08-01 01:01:01.000 |           1 | NULL        |2023-08-01 01:01:02.000 |           2 | NULL        |2023-08-01 01:01:03.000 |           3 | NULL        |2023-08-01 01:01:04.000 |           4 | NULL        |2023-08-01 01:01:05.000 |           5 | NULL        |2023-08-01 01:01:06.000 |           6 | NULL        |2023-08-01 01:01:07.000 |           7 | NULL        |2023-08-01 01:01:08.000 |           8 | NULL        |2023-08-01 01:01:09.000 |           9 | NULL        |2023-08-01 01:01:10.000 |          10 | NULL        |> select _irowts,interp(v1) from t7 range('2023-08-01 01:01:01.000','2023-08-01 01:01:12.000') every(1s) fill(prev);_irowts         | interp(v1)  |
========================================2023-08-01 01:01:01.000 |           1 |2023-08-01 01:01:02.000 |           2 |2023-08-01 01:01:03.000 |           3 |2023-08-01 01:01:04.000 |           4 |2023-08-01 01:01:05.000 |           5 |2023-08-01 01:01:06.000 |           6 |2023-08-01 01:01:07.000 |           7 |2023-08-01 01:01:08.000 |           8 |2023-08-01 01:01:09.000 |           9 |2023-08-01 01:01:10.000 |          10 |2023-08-01 01:01:11.000 |          10 |2023-08-01 01:01:12.000 |          10 |> select _irowts,interp(v1) from t7 range('2023-08-01 01:01:01.000','2023-08-01 01:01:12.000') every(1s) fill(next);_irowts         | interp(v1)  |
========================================2023-08-01 01:01:01.000 |           1 |2023-08-01 01:01:02.000 |           2 |2023-08-01 01:01:03.000 |           3 |2023-08-01 01:01:04.000 |           4 |2023-08-01 01:01:05.000 |           5 |2023-08-01 01:01:06.000 |           6 |2023-08-01 01:01:07.000 |           7 |2023-08-01 01:01:08.000 |           8 |2023-08-01 01:01:09.000 |           9 |2023-08-01 01:01:10.000 |          10 |> select _irowts,interp(v1) from t7 range('2023-08-01 01:01:01.000','2023-08-01 01:01:12.000') every(1s) fill(null);_irowts         | interp(v1)  |
========================================2023-08-01 01:01:01.000 |           1 |2023-08-01 01:01:02.000 |           2 |2023-08-01 01:01:03.000 |           3 |2023-08-01 01:01:04.000 |           4 |2023-08-01 01:01:05.000 |           5 |2023-08-01 01:01:06.000 |           6 |2023-08-01 01:01:07.000 |           7 |2023-08-01 01:01:08.000 |           8 |2023-08-01 01:01:09.000 |           9 |2023-08-01 01:01:10.000 |          10 |2023-08-01 01:01:11.000 | NULL        |2023-08-01 01:01:12.000 | NULL        |

LAST

LAST(expr)

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

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

适用数据类型：所有字段。

适用于：表和超级表。

使用说明:

如果要返回各个列的最后（时间戳最大）一个非 NULL 值，可以使用 LAST(*)；
如果结果集中的某列全部为 NULL 值，则该列的返回结果也是 NULL；如果结果集中所有列全部为 NULL 值，则不返回结果。
在用于超级表时，时间戳完全一样且同为最大的数据行可能有多个，那么会从中随机返回一条，而并不保证多次运行所挑选的数据行必然一致。

示例:

> select * from t7 ;ts            |     v1      |     v2      |
======================================================2023-08-01 01:01:00.000 | NULL        | NULL        |2023-08-01 01:01:01.000 |           1 | NULL        |2023-08-01 01:01:02.000 |           2 | NULL        |2023-08-01 01:01:03.000 |           3 | NULL        |2023-08-01 01:01:04.000 |           4 | NULL        |2023-08-01 01:01:05.000 |           5 | NULL        |2023-08-01 01:01:06.000 |           6 | NULL        |2023-08-01 01:01:07.000 |           7 | NULL        |2023-08-01 01:01:08.000 |           8 | NULL        |2023-08-01 01:01:09.000 |           9 | NULL        |2023-08-01 01:01:10.000 |          10 | NULL        |2023-08-01 01:01:11.000 | NULL        | NULL        |> select last(*) from t7;last(ts)         |  last(v1)   |  last(v2)   |
======================================================2023-08-01 01:01:11.000 |          10 | NULL        |> select ts,last(v1) from t7;ts            |  last(v1)   |
========================================2023-08-01 01:01:10.000 |          10 |taos> select ts,last(v2) from t7;
Query OK, 0 row(s) in set (0.001065s)

LAST_ROW

LAST_ROW(expr)

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

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

适用数据类型：所有字段。

适用于：表和超级表。

使用说明：

在用于超级表时，时间戳完全一样且同为最大的数据行可能有多个，那么会从中随机返回一条，而并不保证多次运行所挑选的数据行必然一致。
不能与 INTERVAL 一起使用。

示例:

> select * from t7;ts            |     v1      |     v2      |
======================================================2023-08-01 01:01:00.000 | NULL        | NULL        |2023-08-01 01:01:01.000 |           1 | NULL        |2023-08-01 01:01:02.000 |           2 | NULL        |2023-08-01 01:01:03.000 |           3 | NULL        |2023-08-01 01:01:04.000 |           4 | NULL        |2023-08-01 01:01:05.000 |           5 | NULL        |2023-08-01 01:01:06.000 |           6 | NULL        |2023-08-01 01:01:07.000 |           7 | NULL        |2023-08-01 01:01:08.000 |           8 | NULL        |2023-08-01 01:01:09.000 |           9 | NULL        |2023-08-01 01:01:10.000 |          10 | NULL        |2023-08-01 01:01:11.000 | NULL        | NULL        |> select last_row(*) from t7;last_row(ts)       | last_row(v1) | last_row(v2) |
========================================================2023-08-01 01:01:11.000 | NULL         | NULL         |> select ts,last_row(v1) from t7;ts            | last_row(v1) |
=========================================2023-08-01 01:01:11.000 | NULL         |> select ts,last_row(v2) from t7;ts            | last_row(v2) |
=========================================2023-08-01 01:01:11.000 | NULL         |

MAX

MAX(expr)

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

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

适用数据类型：数值类型。

适用于：表和超级表。

示例:

> select * from t7;ts            |     v1      |     v2      |
======================================================2023-08-01 01:01:00.000 | NULL        | NULL        |2023-08-01 01:01:01.000 |           1 | NULL        |2023-08-01 01:01:02.000 |           2 | NULL        |2023-08-01 01:01:03.000 |           3 | NULL        |2023-08-01 01:01:04.000 |           4 | NULL        |2023-08-01 01:01:05.000 |           5 | NULL        |2023-08-01 01:01:06.000 |           6 | NULL        |2023-08-01 01:01:07.000 |           7 | NULL        |2023-08-01 01:01:08.000 |           8 | NULL        |2023-08-01 01:01:09.000 |           9 | NULL        |2023-08-01 01:01:10.000 |          10 | NULL        |2023-08-01 01:01:11.000 | NULL        | NULL        |> select max(v1) from t7;max(v1)   |
==============10 |> select max(v2) from t7;max(v2)   |
==============NULL        |

MIN

MIN(expr)

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

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

适用数据类型：数值类型。

适用于：表和超级表。

示例:

> select * from t7;ts            |     v1      |     v2      |
======================================================2023-08-01 01:01:00.000 | NULL        | NULL        |2023-08-01 01:01:01.000 |           1 | NULL        |2023-08-01 01:01:02.000 |           2 | NULL        |2023-08-01 01:01:03.000 |           3 | NULL        |2023-08-01 01:01:04.000 |           4 | NULL        |2023-08-01 01:01:05.000 |           5 | NULL        |2023-08-01 01:01:06.000 |           6 | NULL        |2023-08-01 01:01:07.000 |           7 | NULL        |2023-08-01 01:01:08.000 |           8 | NULL        |2023-08-01 01:01:09.000 |           9 | NULL        |2023-08-01 01:01:10.000 |          10 | NULL        |2023-08-01 01:01:11.000 | NULL        | NULL        |> select min(v2) from t7;min(v2)   |
==============NULL        |> select min(v1) from t7;min(v1)   |
==============1 |

MODE

MODE(expr)

功能说明：返回出现频率最高的值，若存在多个频率相同的最高值，则随机输出其中某个值。

返回数据类型：与输入数据类型一致。

适用数据类型：全部类型字段。

适用于：表和超级表。

示例:

> select * from t7;ts            |     v1      |     v2      |
======================================================2023-08-01 01:01:00.000 | NULL        | NULL        |2023-08-01 01:01:01.000 |           1 | NULL        |2023-08-01 01:01:02.000 |           2 | NULL        |2023-08-01 01:01:03.000 |           3 | NULL        |2023-08-01 01:01:04.000 |           4 | NULL        |2023-08-01 01:01:05.000 |           5 | NULL        |2023-08-01 01:01:06.000 |           6 | NULL        |2023-08-01 01:01:07.000 |           7 | NULL        |2023-08-01 01:01:08.000 |           8 | NULL        |2023-08-01 01:01:09.000 |           9 | NULL        |2023-08-01 01:01:10.000 |          10 | NULL        |2023-08-01 01:01:11.000 | NULL        | NULL        |2023-08-01 01:01:12.000 |          10 | NULL        |> select mode(v1) from t7;mode(v1)   |
==============10 |> select mode(v2) from t7;mode(v2)   |
==============NULL        |

SAMPLE

SAMPLE(expr, k)

功能说明：获取数据的 k 个采样值。参数 k 的合法输入范围是 1≤ k ≤ 1000。

返回结果类型：同原始数据类型。

适用数据类型：全部类型字段。

嵌套子查询支持：适用于内层查询和外层查询。

适用于：表和超级表。

示例:

> select count(*) from db03.meters;count(*)        |
========================109847142 |
Query OK, 1 row(s) in set (2.897577s)taos> select ts,sample(voltage,10) from db03.meters;ts            | sample(voltage,10) |
===============================================2023-08-31 07:28:22.075 |                832 |2023-08-31 07:44:24.141 |                843 |2023-08-30 20:02:05.379 |                571 |2023-08-31 07:39:37.149 |                 64 |2023-08-30 18:17:03.414 |                406 |2023-08-31 01:08:33.140 |                 48 |2023-08-30 22:24:29.888 |                665 |2023-08-31 03:09:20.970 |                317 |2023-08-31 07:52:18.062 |                809 |2023-08-30 23:26:56.370 |                951 |> select ts,sample(current,10) from db03.meters;ts            |  sample(current,10)  |
=================================================2017-07-14 10:40:04.333 |            9.9600000 |2023-08-30 18:38:50.207 |          736.0000000 |2023-08-31 04:04:39.806 |           48.0000000 |2023-08-30 14:07:56.598 |          630.0000000 |2017-07-14 10:40:08.386 |            9.8000002 |2017-07-14 10:40:03.538 |            9.9200001 |2023-08-31 07:30:39.249 |          894.0000000 |2023-08-31 09:45:17.732 |          802.0000000 |2023-08-30 23:24:46.770 |          794.0000000 |2023-08-31 08:50:07.191 |          876.0000000 |> select ts,sample(current,10),tbname from db03.meters;ts            |  sample(current,10)  |                  tbname                  |
============================================================================================2023-08-30 16:46:31.089 |          320.0000000 | d320                                     |2023-08-30 23:38:41.862 |           31.0000000 | d31                                      |2023-08-31 05:31:04.926 |          251.0000000 | d251                                     |2023-08-30 21:06:09.251 |          949.0000000 | d949                                     |2023-08-31 05:58:59.459 |          455.0000000 | d455                                     |2017-07-14 10:40:06.038 |           10.1199999 | d753                                     |2023-08-31 07:10:25.396 |          878.0000000 | d878                                     |2023-08-31 02:55:02.459 |          611.0000000 | d611                                     |2023-08-30 18:21:05.591 |          124.0000000 | d124                                     |2023-08-30 18:19:58.478 |          423.0000000 | d423                                     |> select ts,sample(current,10),tbname from db03.meters;ts            |  sample(current,10)  |                  tbname                  |
============================================================================================2023-08-30 16:57:54.242 |          198.0000000 | d198                                     |2023-08-30 15:50:55.564 |          300.0000000 | d300                                     |2023-08-30 20:23:59.571 |          190.0000000 | d190                                     |2023-08-31 07:23:07.732 |          883.0000000 | d883                                     |2023-08-30 21:00:09.487 |          671.0000000 | d671                                     |2017-07-14 10:40:05.945 |            9.8000002 | d238                                     |2023-08-31 07:23:04.833 |          809.0000000 | d809                                     |2023-08-30 13:56:39.881 |          329.0000000 | d329                                     |2023-08-31 04:08:36.008 |          534.0000000 | d534                                     |2023-08-30 19:54:08.737 |           30.0000000 | d30

TAIL

TAIL(expr, k [, offset_rows])

功能说明：返回跳过最后 offset_val 个，然后取连续 k 个记录，不忽略 NULL 值。offset_val 可以不输入。此时返回最后的 k 个记录。当有 offset_val 输入的情况下，该函数功能等效于 order by ts desc LIMIT k OFFSET offset_val。

参数范围：k: [1,100] offset_val: [0,100]。

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

适用数据类型：适合于除时间主键列外的任何类型。

适用于：表、超级表。

示例:

> select ts,v1 from t7;ts            |     v1      |
========================================2023-08-01 01:01:00.000 | NULL        |2023-08-01 01:01:01.000 |           1 |2023-08-01 01:01:02.000 |           2 |2023-08-01 01:01:03.000 |           3 |2023-08-01 01:01:04.000 |           4 |2023-08-01 01:01:05.000 |           5 |2023-08-01 01:01:06.000 |           6 |2023-08-01 01:01:07.000 |           7 |2023-08-01 01:01:08.000 |           8 |2023-08-01 01:01:09.000 |           9 |2023-08-01 01:01:10.000 |          10 |2023-08-01 01:01:11.000 | NULL        |> select ts,tail(v1,2) from t7;ts            | tail(v1,2)  |
========================================2023-08-01 01:01:11.000 | NULL        |2023-08-01 01:01:10.000 |          10 |> select ts,tail(v1,2,2) from t7;ts            | tail(v1,2,2) |
=========================================2023-08-01 01:01:09.000 |            9 |2023-08-01 01:01:08.000 |            8 |

TOP

TOP(expr, k)

功能说明：统计表/超级表中某列的值最大 k 个非 NULL 值。如果多条数据取值一样，全部取用又会超出 k 条限制时，系统会从相同值中随机选取符合要求的数量返回。

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

适用数据类型：数值类型。

适用于：表和超级表。

使用说明:

k值取值范围 1≤k≤100；
系统同时返回该记录关联的时间戳列；
限制：TOP 函数不支持 FILL 子句。

示例:

> select ts,v1 from t7;ts            |     v1      |
========================================2023-08-01 01:01:00.000 | NULL        |2023-08-01 01:01:01.000 |           1 |2023-08-01 01:01:02.000 |           2 |2023-08-01 01:01:03.000 |           3 |2023-08-01 01:01:04.000 |           4 |2023-08-01 01:01:05.000 |           5 |2023-08-01 01:01:06.000 |           6 |2023-08-01 01:01:07.000 |           7 |2023-08-01 01:01:08.000 |           8 |2023-08-01 01:01:09.000 |           9 |2023-08-01 01:01:10.000 |          10 |2023-08-01 01:01:11.000 | NULL        |2023-08-01 01:01:12.000 |          10 |> select ts,top(v1,3) from t7;ts            |  top(v1,3)  |
========================================2023-08-01 01:01:09.000 |           9 |2023-08-01 01:01:10.000 |          10 |2023-08-01 01:01:12.000 |          10 |

UNIQUE

UNIQUE(expr)

功能说明：返回该列数据首次出现的值。该函数功能与 distinct 相似。

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

适用数据类型：全部类型字段。

适用于: 表和超级表。

示例:

s> select ts,v1 from t7;ts            |     v1      |
========================================2023-08-01 01:01:00.000 | NULL        |2023-08-01 01:01:01.000 |           1 |2023-08-01 01:01:02.000 |           2 |2023-08-01 01:01:03.000 |           3 |2023-08-01 01:01:04.000 |           4 |2023-08-01 01:01:05.000 |           5 |2023-08-01 01:01:06.000 |           6 |2023-08-01 01:01:07.000 |           7 |2023-08-01 01:01:08.000 |           8 |2023-08-01 01:01:09.000 |           9 |2023-08-01 01:01:10.000 |          10 |2023-08-01 01:01:11.000 | NULL        |2023-08-01 01:01:12.000 |          10 |> select unique(v1) from t7;unique(v1)  |
==============NULL        |7 |6 |4 |2 |5 |9 |1 |10 |8 |3 |