InfluxQL 选择器函数

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

示例使用的是提供的示例数据集，详见 开始使用InfluxDB教程.

• BOTTOM()
• FIRST()
• 最后()
• MAX()
• 最小值()
• PERCENTILE()
• 顶部()
• 选择器函数的显著行为

底部()

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

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

参数

• field_expression: 用于标识要操作的字段的表达式。 可以是一个 field key 或常量。
• tag_expression: 用于识别标签键以进行分段的表达式。可以是一个 tag key 或常量。使用逗号分隔多个标签。
• 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(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(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(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(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)

百分位数()

返回第 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)

顶部函数()

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

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

参数

• field_expression: 用于标识要操作的字段的表达式。 可以是一个 field key 或常量。
• tag_expression: 用于识别标签键以进行分段的表达式。可以是一个 tag key 或常量。使用逗号分隔多个标签。
• 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()
• 顶部()

如果 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