InfluxQL 选择器函数

使用选择器函数来评估、选择并返回数据中的值。选择器函数返回来自每个 InfluxQL 分组的所选值的一行或多行。

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

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

BOTTOM()

返回最小的 N 字段值。BOTTOM() 支持整型 64 位和浮点型 64 位的字段值 数据类型。

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