WHERE 子句

使用 WHERE 子句根据 字段值、标签值 和 时间戳 过滤数据。

• 语法
• 运算符
  • 比较运算符
  • 逻辑运算符
• 时间范围
• 正则表达式
• WHERE 子句示例
• 显著行为
  • 单引号和双引号
  • 无法查询多个时间范围

语法

SELECT_clause FROM_clause WHERE <conditional_expression> [(AND|OR) <conditional_expression> [...]]

• 条件表达式：两个操作数之间的比较，结果为 true 或 false。比较逻辑由表达式中使用的 运算符 决定。这些表达式可以对 InfluxDB 字段、标签和时间戳进行操作。使用逻辑运算符（AND、OR）将多个条件表达式连接起来。

运算符

运算符评估两个操作数之间的关系，并返回 true 或 false。

比较运算符

逻辑运算符

时间范围

使用 WHERE 子句指定查询的时间范围。如果在 WHERE 子句中没有指定时间范围，则使用 默认时间范围。

时间戳存储在 time 列中。使用比较运算符将 time 列的值与时间戳文字、整数（Unix 纳秒时间戳）或 表达式 进行比较。

WHERE
  time >= '2023-01-01T00:00:00Z'
  AND time < '2023-07-01T00:00:00Z'

WHERE
  time >= 1672531200000000000
  AND time < 1688169600000000000

WHERE
  time >= now() - 1d
  AND time < now()

有关在 WHERE 子句中指定替代时间范围的详细信息，请参阅 时间语法。

正则表达式

可以使用正则表达式通过正则表达式比较运算符在 WHERE 子句中评估 字符串 值。

• =~: 匹配正则表达式
• !~: 不匹配正则表达式

SELECT * FROM home WHERE room =~ /^K/

有关 InfluxQL 正则表达式语法的更多信息，请参阅 InfluxQL 正则表达式。

WHERE 子句示例

以下示例使用 入门家居传感器示例数据集。

SELECT * FROM home WHERE room = 'Living Room'

SELECT *
FROM home
WHERE
  time >= '2022-01-01T08:00:00Z'
  AND time <= '2022-01-01T10:00:00Z'

SELECT * FROM home WHERE time >= '2022-01-01T20:00:00Z' - 2h

SELECT co FROM home WHERE co > 9

SELECT room, co FROM home WHERE co = 9

SELECT room, co FROM home WHERE co - 10 > 5

SELECT * FROM home WHERE temp > 22.7 AND room = 'Kitchen'

SELECT co, temp FROM home WHERE co > temp

显著行为

• 单引号和双引号
• 无法查询多个时间范围

单引号和双引号

In InfluxQL 中，单引号 (') 和双引号 (") 的作用不同，可能会改变 WHERE 子句的功能。单引号用于 字符串 和 时间戳 文字。双引号用于引用 标识符（时间、字段和标签列名）。

以下条件表达式比较 location 列 的值与 文字字符串 London

"location" = 'London'

以下条件表达式比较 location 列 的值与 London 列 的值

"location" = "London"

在 WHERE 子句中误用双引号和单引号通常会得到意外的空查询结果。有关引号的更多信息，请参阅 InfluxQL 引号。

无法查询多个时间范围

InfluxDB 不支持在 WHERE 子句中使用 OR 来查询多个时间范围。例如，以下查询没有返回结果

SELECT *
FROM home
WHERE
  (time >= '2022-01-01T08:00:00Z' AND time <= '2022-01-01T10:00:00Z')
  OR (time >= '2022-01-01T18:00:00Z' AND time <= '2022-01-01T20:00:00Z')