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