InfluxDB-InfluxQL基礎語法教程--WHERE子句

本文翻譯自官網，官網地址：(https://docs.influxdata.com/influxdb/v1.7/query_language/data_exploration/)

WHERE子句

語法：

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

注：在WHERE子句中，支持在fields, tags, and timestamps上進行條件表達式的運算。
注：在InfluxDB的WHERE子句中，不支持使用 OR 來指定不同的time區間，如下面的sql將會返回空：

SELECT * FROM "absolutismus" WHERE time = '2016-07-31T20:07:00Z' OR time = '2016-07-31T23:07:17Z'

Fields

語法如下：

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

在WHERE子句中，支持對string, boolean, float 和 integer類型的field values進行比較。

注意 ：在WHERE子句中，如果是string類型的field value，一定要用單引號括起來。如果不適用引號括起來，或者使用的是雙引號，將不會返回任何數據，有時甚至都不報錯！

WHERE支持的運算符如下：

Operator	Meaning
=	equal to
<>	not equal to
!=	not equal to
>	greater than
>=	greater than or equal to
<	less than
<=	less than or equal to

支持的更多運算符詳見: Arithmetic Operations, Regular Expressions

Tags

語法如下：

tag_key <operator> ['tag_value']

對於在WHERE子句中的tag values，也要用單引號括起來。如果不用引號括起來，或者使用雙引號，則查詢不會返回任務數據。甚至不會報錯。

Tag支持的運算符如下：

Operator	Meaning
=	equal to
<>	not equal to
!=	not equal to

還支持正則運算: Regular Expressions

Timestamps

對於大部分的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()。

在 Time Syntax 小節將會介紹如何在WHERE子句中指定時間 區間。

---

WHERE示例sql

1. Select data that have specific field key-values
   

2. Select data that have a specific string field key-value
   
   InfluxQL requires single quotes around string field values in the WHERE clause.

3. Select data that have a specific field key-value and perform basic arithmetic
   

4. Select data that have a specific tag key-value
   
   InfluxQL requires single quotes around tag values in the WHERE clause.

5. Select data that have specific field key-values and tag key-values
   
   The WHERE clause supports the operators AND and OR, and supports separating logic with parentheses.

1. Select data that have specific timestamps
   
   該sql將查詢h2o_feet中在7天以內的所有數據

---

關於WHERE語句的常見疑問

問題 ：where子句查詢意外地未返回任何數據。

答 ：通常情況，出現該問題是因爲在WHERE子句中沒有對tag values或string類型的field values使用單引號括起來的緣故。對於WHERE子句中的tag values或string類型的field values，如果沒有用引號括起來，或者是用的雙引號，這種時候，查詢不會返回任何結果，有時甚至也不會報錯。
在下面的示例sql中，對tag value的引號使用做說明。第一個sql沒有對tag value使用引號，第二個sql對tag value使用了雙引號，第三個sql則對tag value使用了單引號。可以看到，第一和第二個sql都沒有返回任何查詢結果，而第三個sql返回了預期中的結果。

在下面的sql對string類型的field value的引號情況做說明，其中field value爲“at or greater than 9 feet”。第一個sql沒有對field value使用引號，第二個sql對field value使用了雙引號，第三個sql則對field value使用了單引號。可以看到，第一個sql報錯了，因爲field valus中包含了空格。第二個sql雖然沒報錯，但是查詢結果爲空。第三個sql返回了預期中的結果。