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