InfluxDb中的数据查询语法where子句

本节讲解where子句，注意，查询语言是大小写无关的哈。

influxdb的where语法

SELECT_clause FROM_clause WHERE <conditional_expression> [(AND|OR) <conditional_expression> [...]]
  • 可以有多个条件表达式conditional_expression
  • 条件表达式之间可以有AND和OR

语法描述

WHERE子句后可以写写field，tag和timestamp。

conditional_expressions.

where 子句中包含fields时

where子句语法：

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

WHERE子句支持field value是字符串，布尔型，浮点数和整数这些类型。

在WHERE子句中单引号来表示字符串字段值。不加引号或者用双引号，不会返回结果，也不会返回错误。

支持的操作符operator如下：

  • = 等于
  • <> 不等于
  • != 不等于
  • > 大于
  • >= 大于等于
  • < 小于
  • <= 小于等于

where 子句中包含tags时

tag_key <operator> ['tag_value']

WHERE子句中的用单引号来把tag value引起来。具不加引号或者用双引号，不会返回结果，也不会返回错误。

支持的操作符：

  • = 等于
  • <> 不等于
  • != 不等于

timestamps

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

Where语句的例子

例一：查询有特定field的key value的数据

use NOAA_water_database
SELECT * FROM "h2o_feet" WHERE "water_level" > 8

name: h2o_feet
--------------
time                   level description      location       water_level
2015-08-18T00:00:00Z   between 6 and 9 feet   coyote_creek   8.12
2015-08-18T00:06:00Z   between 6 and 9 feet   coyote_creek   8.005
[...]
2015-09-18T00:12:00Z   between 6 and 9 feet   coyote_creek   8.189
2015-09-18T00:18:00Z   between 6 and 9 feet   coyote_creek   8.084

这个查询将会返回measurement为h2o_feet，字段water_level的值大于8的数据。

例二：查询有特定field的key value为字符串的数据

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

name: h2o_feet
--------------
time                   level description   location       water_level
2015-08-18T00:00:00Z   below 3 feet        santa_monica   2.064
2015-08-18T00:06:00Z   below 3 feet        santa_monica   2.116
[...]
2015-09-18T14:06:00Z   below 3 feet        santa_monica   2.999
2015-09-18T14:36:00Z   below 3 feet        santa_monica   2.907

该查询从h2o_feet返回数据，其中level description等于below 3 feet。InfluxQL在WHERE子句中需要单引号来将字符串field value引起来。

field value用双引号是一种错误哦，不会返回数据哦：

influx-where

例三：查询有特定field的key value并且带计算的数据

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

name: h2o_feet
--------------
time                   level description           location       water_level
2015-08-29T07:06:00Z   at or greater than 9 feet   coyote_creek   9.902
2015-08-29T07:12:00Z   at or greater than 9 feet   coyote_creek   9.938
2015-08-29T07:18:00Z   at or greater than 9 feet   coyote_creek   9.957
2015-08-29T07:24:00Z   at or greater than 9 feet   coyote_creek   9.964
2015-08-29T07:30:00Z   at or greater than 9 feet   coyote_creek   9.954
2015-08-29T07:36:00Z   at or greater than 9 feet   coyote_creek   9.941
2015-08-29T07:42:00Z   at or greater than 9 feet   coyote_creek   9.925
2015-08-29T07:48:00Z   at or greater than 9 feet   coyote_creek   9.902
2015-09-02T23:30:00Z   at or greater than 9 feet   coyote_creek   9.902

该查询从h2o_feet返回数据，其字段值为water_level加上2大于11.9。

例四：查询有特定tag的key value的数据

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

name: h2o_feet
--------------
time                   water_level
2015-08-18T00:00:00Z   2.064
2015-08-18T00:06:00Z   2.116
[...]
2015-09-18T21:36:00Z   5.066
2015-09-18T21:42:00Z   4.938

该查询从h2o_feet返回数据，其中tag location为santa_monica。InfluxQL需要WHERE子句中tag的过滤带单引号。

注意：时间无论你指定没有，都是会显示的。

例五：查询有特定tag的key value以及特定field的key value的数据

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

name: h2o_feet
--------------
time                   water_level
2015-08-29T07:18:00Z   9.957
2015-08-29T07:24:00Z   9.964
2015-08-29T07:30:00Z   9.954
2015-08-29T14:30:00Z   -0.61
2015-08-29T14:36:00Z   -0.591
2015-08-30T15:18:00Z   -0.594

该查询从h2o_feet中返回数据，其中tag location设置为santa_monica，并且field water_level的值小于-0.59或大于9.95。 WHERE子句支持运算符AND和OR，并支持用括号分隔逻辑。

例六：根据时间戳来过滤数据

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

该查询返回来自h2o_feet，该measurement在过去七天内的数据。

你也许什么也查不出来，因为数据库的时间远远大于7天。减去500d，可能会有值。

WHERE子句常见的问题

问题一：WHERE子句返回结果为空

在大多数情况下，这个问题是tag value或field value缺少单引号的结果。具有无引号或双引号tag value或field value的查询将不会返回任何数据，并且在大多数情况下不会返回错误。

下面的代码块中的前两个查询尝试指定tag value为santa_monica，没有任何引号和双引号。那些查询不会返回结果。 第三个查询单引号santa_monica（这是支持的语法），并返回预期的结果。

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

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

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

name: h2o_feet
--------------
time                   water_level
2015-08-18T00:00:00Z   2.064
[...]
2015-09-18T21:42:00Z   4.938

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

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

ERR: error parsing query: found than, expected ; at line 1, char 86

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

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

name: h2o_feet
--------------
time                   level description
2015-08-26T04:00:00Z   at or greater than 9 feet
[...]
2015-09-15T22:42:00Z   at or greater than 9 feet