4.InfluxDB-InfluxQL基础语法教程--基本select语句

时间:2022-06-18 04:09:32

本文翻译自官网,官网地址:(https://docs.influxdata.com/influxdb/v1.7/query_language/data_exploration/)
基本语法如下:

SELECT <field_key>[,<field_key>,<tag_key>] FROM <measurement_name>[,<measurement_name>]

可见,select语句是由SELECT子句和FROM子句组成的。

一、SELECT子句

在SELECT字句中,有如下几种形式,分别用于查询各种指定的数据:

语法 意思
SELECT * 查询measurement中所有的fields和 tags。示例sql:select * from h2o_feet;
SELECT "<field_key>" 查询指定的一个field。示例sql:select water_level from h2o_feet;
SELECT "<field_key>","<field_key>" 查询多个field。示例sql:select "level description", "water_level" from h2o_feet;
SELECT "<field_key>","<tag_key>" ?查询指定的field和tag。示例sql:select water_level,location from h2o_feet; :在SELECT子句中,如果包含了tag,那么此时就必须指定至少一个field。比如如下的sql就是错误的,因为它只select了一个tag,而没有field:select location from h2o_feet;
SELECT "<field_key>"::field,"<tag_key>"::tag 跟上面一样,也是查询指定的field和tag。 ::[field | tag]语法用来指定标识符的类型,因为有时候tag和field有可能同名,因此用 ::[field | tag]语法来加以区分。

在SELECT子句中,还包含数学运算聚合函数基本的类型转换正则表达式等

二、FROM子句

FROM子句用于指定要查询的measurement,支持的语法如下:

语法 意思
FROM <measurement_name> 从指定measurement中查询数据。这种方式会从当前DB、默认retention policy的measurement中查询数据。
FROM <measurement_name>,<measurement_name> 从多个measurement中查询数据
FROM <database_name>.<retention_policy_name>.<measurement_name> 从指定DB、指定retention policy的measurement中查询数据
FROM <database_name>..<measurement_name> 从指定DB、默认retention policy的measurement 中查询数据

FROM子句中还支持正则表达式

关于引号

如果measurement、tag、field等的标识符除了[A-z,0-9,_]之外,还有其他字符,或者标识符是keyword关键字,那么在引用的时候必须加上双引号。比如在表 h2o_feet 中,"level description"就是一个带有空格的field,如此一来在查询到的时候,就必须加上双引号了。如下图,在查询level description时若不加双引号,则会报错。
4.InfluxDB-InfluxQL基础语法教程--基本select语句

官方推荐,虽然有些标识符不是必须使用双引号,但是推荐对所有标识符使用双引号!

示例sql

  1. 从单个measurement中查询该measurement所有的tag和field
    4.InfluxDB-InfluxQL基础语法教程--基本select语句

  2. 从单个measurement中查询指定的tag和field
    4.InfluxDB-InfluxQL基础语法教程--基本select语句

  3. 从单个measurement中查询指定的tag和field,并指定它们的标识类型
    4.InfluxDB-InfluxQL基础语法教程--基本select语句
    这种方式一般使用较少。

  4. 从measurement中查询所有的field
    4.InfluxDB-InfluxQL基础语法教程--基本select语句
    The SELECT clause supports combining the * syntax with the :: syntax.

  5. 在查询时进行基本的数学运算
    4.InfluxDB-InfluxQL基础语法教程--基本select语句
    InfluxDB遵循标准的四则运算规则。更多操作详见Mathematical Operators

  6. 同时从多个measurement中查询它们的所有数据
    4.InfluxDB-InfluxQL基础语法教程--基本select语句

  7. 从一个全路径的measurement中查询数据
    4.InfluxDB-InfluxQL基础语法教程--基本select语句
    可见,所谓的全路径,其实就是指在FROM子句中,指定了measurement所在的DB,以及要查询数据所在的retention policy。

  8. 查询指定数据库中的measurement的数据
    4.InfluxDB-InfluxQL基础语法教程--基本select语句
    The query selects data in the NOAA_water_database, the DEFAULT retention policy, and the h2o_feet measurement. The .. indicates the DEFAULT retention policy for the specified database.

关于SELECT语句的常见疑问

在SELECT 子句中,必须要有至少一个field key!如果在SELECT子句中只有一个或多个tag key,那么该查询会返回空。这是由InfluxDB底层存储数据的方式所导致的结果。
示例

4.InfluxDB-InfluxQL基础语法教程--基本select语句
上面的查询结果返回为空,是因为在它的SELECT子句中,只查询了location这个tag key。
如果想要查询跟location这个tag key有关的任何数据,则在SELECT字句中必须至少要包含一个field key,如下:
4.InfluxDB-InfluxQL基础语法教程--基本select语句