InfluxQL 选择器函数

使用选择器函数来评估、选择和返回数据中的值。选择器函数为每个 InfluxQL 组返回一行或多行包含所选值的数据。

示例使用InfluxDB 快速入门教程中提供的示例数据集。

• BOTTOM()
• FIRST()
• LAST()
• MAX()
• MIN()
• PERCENTILE()
• TOP()
• 选择器函数的显著行为

BOTTOM()

返回最小的 N 个字段值。BOTTOM() 支持 int64 和 float64 字段值数据类型。

BOTTOM(field_expression[, tag_expression_1[, ..., tag_expression_n]], N)

参数

• field_expression：用于标识要操作的字段的表达式。可以是字段键或常量。
• tag_expression：用于标识要按其分段的标签键的表达式。可以是标签键或常量。使用逗号分隔多个标签。
• N：从每个 InfluxQL 组或指定的标签段返回的结果数。

显著行为

• 当按时间分组时，BOTTOM()保持原始时间戳。
• BOTTOM()可能会返回少于预期的数据点。

示例

SELECT BOTTOM(temp, 3) FROM home

SELECT BOTTOM(temp, room, 2) FROM home

SELECT BOTTOM(temp, 3), room FROM home

SELECT
  BOTTOM(temp, room, 2)
FROM home
WHERE
  time >= '2022-01-01T08:00:00Z'
  AND time <= '2022-01-01T12:00:00Z'
GROUP BY time(2h)

FIRST()

返回具有最旧时间戳的字段值。

FIRST(field_expression)

参数

• field_expression：用于标识要操作的一个或多个字段的表达式。可以是字段键、常量、正则表达式或通配符 (*)。支持所有字段数据类型。

显著行为

• 当按时间分组时，FIRST()覆盖原始时间戳

示例

SELECT FIRST(temp) FROM home

SELECT FIRST(*) FROM home

SELECT FIRST(/^[th]/) FROM home

SELECT
  FIRST(temp)
FROM home 
WHERE
  room = 'Kitchen'
  AND time >= '2022-01-01T08:00:00Z'
  AND time <= '2022-01-01T20:00:00Z'
GROUP BY time(6h)

LAST()

返回具有最新时间戳的字段值。

LAST(field_expression)

参数

• field_expression：用于标识要操作的一个或多个字段的表达式。可以是字段键、常量、正则表达式或通配符 (*)。支持所有字段数据类型。

显著行为

• 当按时间分组时，LAST()覆盖原始时间戳

示例

SELECT LAST(temp) FROM home

SELECT LAST(*) FROM home

SELECT LAST(/^[th]/) FROM home

SELECT
  LAST(temp)
FROM home 
WHERE
  room = 'Kitchen'
  AND time >= '2022-01-01T08:00:00Z'
  AND time <= '2022-01-01T20:00:00Z'
GROUP BY time(6h)

MAX()

返回最大的字段值。

MAX(field_expression)

参数

• field_expression：用于标识要操作的一个或多个字段的表达式。可以是字段键、常量、正则表达式或通配符 (*)。支持数值字段。

显著行为

• 当按时间分组时，MAX()覆盖原始时间戳。

示例

SELECT MAX(co) FROM home

SELECT MAX(*) FROM home

SELECT MAX(/^[th]/) FROM home

SELECT
  MAX(temp)
FROM home
WHERE
  room = 'Kitchen'
  AND time >= '2022-01-01T08:00:00Z'
  AND time <= '2022-01-01T20:00:00Z'
GROUP BY time(6h)

MIN()

返回最小的字段值。

MIN(field_expression)

参数

• field_expression：用于标识要操作的一个或多个字段的表达式。可以是字段键、常量、正则表达式或通配符 (*)。支持数值字段。

显著行为

• 当按时间分组时，MIN()覆盖原始时间戳。

示例

SELECT MIN(temp) FROM home

SELECT MIN(*) FROM home

SELECT MIN(/^[th]/) FROM home

SELECT
  MIN(temp)
FROM home
WHERE
  room = 'Kitchen'
  AND time >= '2022-01-01T08:00:00Z'
  AND time <= '2022-01-01T20:00:00Z'
GROUP BY time(6h)

PERCENTILE()

返回第 N 个百分位数字段值。

PERCENTILE(field_expression, N)

参数

• field_expression：用于标识要操作的一个或多个字段的表达式。可以是字段键、常量、正则表达式或通配符 (*)。支持数值字段。
• N：要返回的百分位数。必须是大于 0 且小于或等于 100 的整数或浮点值。

显著行为

• 当按时间分组时，PERCENTILE()覆盖原始时间戳。
• PERCENTILE(example_field, 100) 等同于 MAX(example_field)。
• PERCENTILE(example_field, 50) 几乎等同于 MEDIAN(example_field)，但如果字段包含偶数个值，则 MEDIAN() 返回两个中间值的平均值。
• PERCENTILE(example_field, 0) 返回 null。

示例

SELECT PERCENTILE(temp, 50) FROM home

SELECT PERCENTILE(*, 50) FROM home

SELECT PERCENTILE(/^[th]/, 50) FROM home

SELECT
  PERCENTILE(temp, 50)
FROM home
WHERE
  room = 'Kitchen'
  AND time >= '2022-01-01T08:00:00Z'
  AND time <= '2022-01-01T20:00:00Z'
GROUP BY time(6h)

TOP()

返回最大的 N 个字段值。TOP() 支持 int64 和 float64 字段值数据类型。

TOP(field_expression[, tag_expression_1[, ..., tag_expression_n]], N)

参数

• field_expression：用于标识要操作的字段的表达式。可以是字段键或常量。
• tag_expression：用于标识要按其分段的标签键的表达式。可以是标签键或常量。使用逗号分隔多个标签。
• N：从每个 InfluxQL 组或指定的标签段返回的结果数。

显著行为

• 当按时间分组时，TOP()保持原始时间戳。
• TOP()可能会返回少于预期的数据点。

示例

SELECT TOP(temp, 3) FROM home

SELECT TOP(temp, room, 2) FROM home

SELECT TOP(temp, 3), room FROM home

SELECT
  TOP(temp, room, 2)
FROM home
WHERE
  time >= '2022-01-01T08:00:00Z'
  AND time <= '2022-01-01T12:00:00Z'
GROUP BY time(2h)

选择器函数的显著行为

• 按时间分组时的时间戳
• 选择器函数可能会返回少于预期的数据点

按时间分组时的时间戳

当将选择器函数与 GROUP BY time() 子句一起使用时，大多数选择器函数会返回每个时间间隔的起始边界的时间戳。但是，具有指定每个组要返回的结果数量的 N 参数的函数会保持每个返回数据点的原始时间戳。

选择器函数可能会返回少于预期的数据点

使用以下带有 N 参数的选择器函数的查询可能会返回少于预期的数据点。

• BOTTOM()
• TOP()

如果 InfluxQL 组或指定的标签键包含 X 个数据点或唯一标签值，并且 X 小于 N，则该函数将为每个组或标签值返回 X 个结果而不是 N 个。

SELECT BOTTOM(temp, 5)
FROM home
WHERE
  time >= '2022-01-01T08:00:00Z'
  AND time <= '2022-01-01T10:00:00Z'
  AND room = 'Kitchen'

SELECT TOP(temp, room, 3) FROM home