InfluxQL 聚合函数
使用聚合函数来评估、聚合和返回数据中的值。聚合函数返回一行，其中包含每个 InfluxQL 组的聚合值。
示例使用InfluxDB 入门教程中提供的示例数据集。
缺少 InfluxQL 函数
一些 InfluxQL 函数正在重新架构中，以便与 InfluxDB 3 存储引擎一起工作。如果您需要的函数不在此处，请查看 InfluxQL 功能支持页面 以获取更多信息。
COUNT()
返回非空字段值的数量。
参数
- field_expression：用于标识要操作的一个或多个字段的表达式。可以是字段键、常量、正则表达式或通配符 (
*)。支持所有字段类型。
示例
计算字段中非空值的数量
SELECT COUNT(temp) FROM home
| 时间 | 计数 |
|---|
| 1970-01-01T00:00:00Z | 26 |
计算每个字段中非空值的数量
SELECT COUNT(*) FROM home
| 时间 | count_co | count_hum | count_temp |
|---|
| 1970-01-01T00:00:00Z | 26 | 26 | 26 |
计算字段键与正则表达式匹配的字段中非空值的数量
SELECT COUNT(/^[th]/) FROM home
| 时间 | count_hum | count_temp |
|---|
| 1970-01-01T00:00:00Z | 26 | 26 |
计算字段的唯一值
InfluxQL 支持在 COUNT() 中嵌套 DISTINCT()。
SELECT COUNT(DISTINCT(co)) FROM home
| 时间 | 计数 |
|---|
| 1970-01-01T00:00:00Z | 12 |
计算时间窗口（按时间分组）内非空字段值的数量
SELECT
COUNT(temp)
FROM home
WHERE
room = 'Kitchen'
AND time >= '2022-01-01T08:00:00Z'
AND time <= '2022-01-01T20:00:00Z'
GROUP BY time(6h)
| 时间 | 计数 |
|---|
| 2022-01-01T06:00:00Z | 4 |
| 2022-01-01T12:00:00Z | 6 |
| 2022-01-01T18:00:00Z | 3 |
DISTINCT()
返回唯一字段值的列表。
参数
- field_key：从中返回唯一值的字段键。支持所有字段类型。
值得注意的行为
- InfluxQL 支持将
DISTINCT() 与 COUNT() 嵌套使用。
示例
列出唯一字段值
SELECT DISTINCT(co) FROM home
| 时间 | 唯一值 |
|---|
| 1970-01-01T00:00:00Z | 0 |
| 1970-01-01T00:00:00Z | 1 |
| 1970-01-01T00:00:00Z | 3 |
| 1970-01-01T00:00:00Z | 4 |
| 1970-01-01T00:00:00Z | 7 |
| 1970-01-01T00:00:00Z | 5 |
| 1970-01-01T00:00:00Z | 9 |
| 1970-01-01T00:00:00Z | 18 |
| 1970-01-01T00:00:00Z | 14 |
| 1970-01-01T00:00:00Z | 22 |
| 1970-01-01T00:00:00Z | 17 |
| 1970-01-01T00:00:00Z | 26 |
MEAN()
返回字段值的算术平均值（平均数）。
参数
- field_expression：用于标识要操作的一个或多个字段的表达式。可以是字段键、常量、正则表达式或通配符 (
*)。支持数字字段。
示例
计算字段的平均值
SELECT MEAN(temp) FROM home
| 时间 | 平均值 |
|---|
| 1970-01-01T00:00:00Z | 22.396153846153844 |
计算每个字段的平均值
| 时间 | mean_co | mean_hum | mean_temp |
|---|
| 1970-01-01T00:00:00Z | 5.269230769230769 | 36.15 | 22.396153846153844 |
计算字段键与正则表达式匹配的字段的平均值
SELECT MEAN(/^[th]/) FROM home
| 时间 | mean_hum | mean_temp |
|---|
| 1970-01-01T00:00:00Z | 36.15 | 22.396153846153844 |
计算时间窗口（按时间分组）内字段的平均值
SELECT
MEAN(temp)
FROM home
WHERE
room = 'Kitchen'
AND time >= '2022-01-01T08:00:00Z'
AND time <= '2022-01-01T20:00:00Z'
GROUP BY time(6h)
| 时间 | 平均值 |
|---|
| 2022-01-01T06:00:00Z | 22.275 |
| 2022-01-01T12:00:00Z | 22.649999999999995 |
| 2022-01-01T18:00:00Z | 23.033333333333335 |
从排序的字段值列表中返回中间值。
参数
- field_expression：用于标识要操作的一个或多个字段的表达式。可以是字段键、常量、正则表达式或通配符 (
*)。支持数字字段。
值得注意的行为
示例
MODE()
返回字段值列表中最频繁的值。
参数
- field_expression：用于标识要操作的一个或多个字段的表达式。可以是字段键、常量、正则表达式或通配符 (
*)。支持所有字段类型。
值得注意的行为
- 如果两个或多个值的最大出现次数相同，则
MODE() 返回时间戳最早的字段值。
示例
计算字段的众数
SELECT MODE(co) FROM home
| 时间 | 众数 |
|---|
| 1970-01-01T00:00:00Z | 0 |
计算每个字段的众数
| 时间 | mode_co | mode_hum | mode_temp |
|---|
| 1970-01-01T00:00:00Z | 0 | 36 | 22.7 |
计算与正则表达式匹配的字段键的众数
SELECT MODE(/^[th]/) FROM home
| 时间 | mode_hum | mode_temp |
|---|
| 1970-01-01T00:00:00Z | 36 | 22.7 |
计算时间窗口（按时间分组）内字段的众数
SELECT
MODE(co)
FROM home
WHERE
room = 'Kitchen'
AND time >= '2022-01-01T08:00:00Z'
AND time <= '2022-01-01T20:00:00Z'
GROUP BY time(6h)
| 时间 | 众数 |
|---|
| 2022-01-01T06:00:00Z | 0 |
| 2022-01-01T12:00:00Z | 1 |
| 2022-01-01T18:00:00Z | 18 |
SPREAD()
返回最小和最大字段值之间的差值。
参数
- field_expression：用于标识要操作的一个或多个字段的表达式。可以是字段键、常量、正则表达式或通配符 (
*)。支持数字字段。
示例
计算字段的范围
SELECT SPREAD(temp) FROM home
| 时间 | 范围 |
|---|
| 1970-01-01T00:00:00Z | 2.3000000000000007 |
计算每个字段的范围
SELECT SPREAD(*) FROM home
| 时间 | spread_co | spread_hum | spread_temp |
|---|
| 1970-01-01T00:00:00Z | 26 | 1 | 2.3000000000000007 |
计算与正则表达式匹配的字段键的范围
SELECT SPREAD(/^[th]/) FROM home
| 时间 | spread_hum | spread_temp |
|---|
| 1970-01-01T00:00:00Z | 1 | 2.3000000000000007 |
计算时间窗口（按时间分组）内字段的范围
SELECT
SPREAD(co)
FROM home
WHERE
room = 'Kitchen'
AND time >= '2022-01-01T08:00:00Z'
AND time <= '2022-01-01T20:00:00Z'
GROUP BY time(6h)
| 时间 | 范围 |
|---|
| 2022-01-01T06:00:00Z | 0 |
| 2022-01-01T12:00:00Z | 9 |
| 2022-01-01T18:00:00Z | 8 |
STDDEV()
返回字段值的标准差。
参数
- field_expression：用于标识要操作的一个或多个字段的表达式。可以是字段键、常量、正则表达式或通配符 (
*)。支持数字字段。
示例
计算字段的标准差
SELECT STDDEV(temp) FROM home
| 时间 | 标准差 |
|---|
| 1970-01-01T00:00:00Z | 0.5553238833191091 |
计算每个字段的标准差
SELECT STDDEV(*) FROM home
| 时间 | stddev_co | stddev_hum | stddev_temp |
|---|
| 1970-01-01T00:00:00Z | 7.774613519951676 | 0.25495097567963926 | 0.5553238833191091 |
计算字段键与正则表达式匹配的字段的标准差
SELECT STDDEV(/^[th]/) FROM home
| 时间 | stddev_hum | stddev_temp |
|---|
| 1970-01-01T00:00:00Z | 0.25495097567963926 | 0.5553238833191091 |
计算时间窗口（按时间分组）内字段的标准差
SELECT
STDDEV(co)
FROM home
WHERE
room = 'Kitchen'
AND time >= '2022-01-01T08:00:00Z'
AND time <= '2022-01-01T20:00:00Z'
GROUP BY time(6h)
| 时间 | 标准差 |
|---|
| 2022-01-01T06:00:00Z | 0 |
| 2022-01-01T12:00:00Z | 3.6742346141747673 |
| 2022-01-01T18:00:00Z | 4 |
SUM()
返回字段值的总和。
参数
- field_expression：用于标识要操作的一个或多个字段的表达式。可以是字段键、常量、正则表达式或通配符 (
*)。支持数字字段。
示例
计算字段中值的总和
| 时间 | 总和 |
|---|
| 1970-01-01T00:00:00Z | 137 |
计算每个字段中值的总和
| 时间 | sum_co | sum_hum | sum_temp |
|---|
| 1970-01-01T00:00:00Z | 137 | 939.9 | 582.3 |
计算字段键与正则表达式匹配的字段的值的总和
SELECT SUM(/^[th]/) FROM home
| 时间 | sum_hum | sum_temp |
|---|
| 1970-01-01T00:00:00Z | 939.9 | 582.3 |
计算时间窗口（按时间分组）内字段的值的总和
SELECT
SUM(co)
FROM home
WHERE
room = 'Kitchen'
AND time >= '2022-01-01T08:00:00Z'
AND time <= '2022-01-01T20:00:00Z'
GROUP BY time(6h)
| 时间 | 总和 |
|---|
| 2022-01-01T06:00:00Z | 0 |
| 2022-01-01T12:00:00Z | 21 |
| 2022-01-01T18:00:00Z | 66 |
支持和反馈
感谢您成为我们社区的一份子！我们欢迎并鼓励您提供关于 InfluxDB 3 Core 和本文档的反馈和错误报告。如需获得支持，请使用以下资源
拥有年度合同或支持合同的客户可以联系 InfluxData 支持。
