WHERE 子句

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

• 语法
• 示例
• 常见问题

语法

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

WHERE 子句支持对字段、标签和时间戳的 conditional_expressions。

SELECT * FROM "mydb" WHERE time = '2020-07-31T20:07:00Z' OR time = '2020-07-31T23:07:17Z'`

字段

field_key <operator> ['string' | boolean | float | integer]

WHERE 子句支持针对字符串、布尔值、浮点数和整数字段值进行比较。

在 WHERE 子句中，使用单引号引用字符串字段值。使用未加引号的字符串字段值或双引号字符串字段值的查询不会返回任何数据，并且在大多数情况下，不会返回错误。

支持的运算符

InfluxQL 还支持正则表达式。

标签

tag_key <operator> ['tag_value']

在 WHERE 子句中，使用单引号引用标签值。使用未加引号的标签值或双引号标签值的查询不会返回任何数据，并且在大多数情况下，不会返回错误。

支持的运算符

时间戳

对于大多数 SELECT 语句，默认时间范围介于1677-09-21 00:12:43.145224194 和 2262-04-11T23:47:16.854775806Z UTC之间。对于带有GROUP BY time() 子句的 SELECT 语句，默认时间范围介于 1677-09-21 00:12:43.145224194 UTC 和 now() 之间。

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

示例

SELECT * FROM "h2o_feet" WHERE "water_level" > 9

SELECT * FROM "h2o_feet" WHERE "level description" = 'below 3 feet'

SELECT * FROM "h2o_feet" WHERE "water_level" + 2 > 11.9

SELECT "water_level" FROM "h2o_feet" WHERE "location" = 'santa_monica'

SELECT "water_level" FROM "h2o_feet" WHERE "location" <> 'santa_monica' AND (water_level < -0.59 OR water_level > 9.95)

SELECT * FROM "h2o_feet" WHERE time > now() - 7d

该查询从 h2o_feet 测量中返回过去七天内的时间戳。有关 WHERE 子句中支持的时间语法的更深入信息，请参阅时间语法。

WHERE 子句的常见问题

WHERE 子句查询意外地未返回任何数据

在大多数情况下，此问题是由于标签值或字符串字段值周围缺少单引号造成的。使用未加引号或双引号的标签值或字符串字段值的查询不会返回任何数据，并且在大多数情况下，不会返回错误。

以下代码块中的前两个查询尝试指定未加引号和使用双引号的标签值 santa_monica。这些查询未返回任何结果。第三个查询使用单引号引用 santa_monica（这是支持的语法），并返回预期的结果。

SELECT "water_level" FROM "h2o_feet" WHERE "location" = santa_monica
No results

SELECT "water_level" FROM "h2o_feet" WHERE "location" = "santa_monica"
No results

SELECT "water_level" FROM "h2o_feet" WHERE "location" = 'santa_monica'

输出

以下代码块中的前两个查询尝试指定未加引号和使用双引号的字符串字段值 at or greater than 9 feet。第一个查询返回错误，因为字符串字段值包含空格。第二个查询未返回任何结果。第三个查询使用单引号引用 at or greater than 9 feet（这是支持的语法），并返回预期的结果。

SELECT "level description" FROM "h2o_feet" WHERE "level description" = at or greater than 9 feet
ERR: 400 Bad Request: failed to parse query: found than, expected ; at line 1, char 86

SELECT "level description" FROM "h2o_feet" WHERE "level description" = "at or greater than 9 feet"
No results

SELECT "level description" FROM "h2o_feet" WHERE "level description" = 'at or greater than 9 feet'

输出