文档

Schema探索

更新时间:
一键部署

InfluxQL是一种类似SQL的查询语言,用于与TSDB For InfluxDB®中的数据进行交互。以下章节介绍了实用的查询schema的语法。

SHOW DATABASES

SHOW RETENTION POLICIES

SHOW SERIES

SHOW MEASUREMENTS

SHOW TAG KEYS

SHOW TAG VALUES

SHOW FIELD KEYS

-

-

说明

本文档使用的数据可在示例数据章节中下载。

示例数据

在开始之前,请先登录Influx CLI。

$ influx -precision rfc3339
Connected to http://localhost:8086 version 1.7.x
InfluxDB shell 1.7.x
>

注意

除了使用以下语法,更建议您在控制台做database查询和操作语法。

SHOW DATABASES

返回当前账号有权查看的所有数据库。

SHOW DATABASES

示例

运行SHOW DATABASES查询

> SHOW DATABASES

name: databases
name
----
NOAA_water_database
_internal

该查询以表格的形式返回数据库的名称。当前账号有权限查看数据库NOAA_water_database_internal

SHOW RETENTION POLICIES

返回指定数据库的所有数据保留策略。

SHOW RETENTION POLICIES [ON <database_name>]

语法描述

ON <database_name>是可选的。如果查询中没有包含ON <database_name>,您必须在CLI中使用USE <database_name>指定数据库,或者在HTTP API请求中使用参数db指定数据库。

示例

示例一:运行带有ON子句的SHOW RETENTION POLICIES查询

> SHOW RETENTION POLICIES ON NOAA_water_database

name      duration   shardGroupDuration   replicaN   default
----      --------   ------------------   --------   -------
autogen   0s         168h0m0s             1          true

该查询以表格的形式返回数据库NOAA_water_database中所有的保留策略。这个数据库有一个名为autogen的保留策略,该保留策略具有无限的持续时间,为期7天的shard group持续时间,复制系数为1,并且它是这个数据库的默认(DEFAULT)保留策略。

示例二:运行不带有ON子句的SHOW RETENTION POLICIES查询

使用USE <database_name>指定数据库

> USE NOAA_water_database
Using database NOAA_water_database

> SHOW RETENTION POLICIES

name      duration   shardGroupDuration   replicaN   default
----      --------   ------------------   --------   -------
autogen   0s         168h0m0s             1          true

使用参数db指定数据库

~# curl -G "http://localhost:8086/query?db=NOAA_water_database&pretty=true" --data-urlencode "q=SHOW RETENTION POLICIES"

{
    "results": [
        {
            "statement_id": 0,
            "series": [
                {
                    "columns": [
                        "name",
                        "duration",
                        "shardGroupDuration",
                        "replicaN",
                        "default"
                    ],
                    "values": [
                        [
                            "autogen",
                            "0s",
                            "168h0m0s",
                            1,
                            true
                        ]
                    ]
                }
            ]
        }
    ]
}

SHOW SERIES

返回指定数据库的序列。

语法

SHOW SERIES [ON <database_name>] [FROM_clause] [WHERE <tag_key> <operator> [ '<tag_value>' | <regular_expression>]] [LIMIT_clause] [OFFSET_clause]

语法描述

ON <database_name>是可选的。如果查询中没有包含ON <database_name>,您必须在CLI中使用USE <database_name>指定数据库,或者在HTTP API请求中使用参数db指定数据库。

FROM子句,WHERE子句,LIMIT子句和OFFSET子句是可选的。WHERE子句支持tag比较;在SHOW SERIES查询中,field比较是无效的。

WHERE子句中支持的操作符:

=

等于

<>

不等于

!=

不等于

=~

匹配

!~

不匹配

请查阅数据探索章节获得关于FROM子句、LIMIT子句、OFFSET子句和正则表达式的介绍。

示例

示例一:运行带有ON子句的SHOW SERIES查询

> SHOW SERIES ON NOAA_water_database

key
---
average_temperature,location=coyote_creek
average_temperature,location=santa_monica
h2o_feet,location=coyote_creek
h2o_feet,location=santa_monica
h2o_pH,location=coyote_creek
h2o_pH,location=santa_monica
h2o_quality,location=coyote_creek,randtag=1
h2o_quality,location=coyote_creek,randtag=2
h2o_quality,location=coyote_creek,randtag=3
h2o_quality,location=santa_monica,randtag=1
h2o_quality,location=santa_monica,randtag=2
h2o_quality,location=santa_monica,randtag=3
h2o_temperature,location=coyote_creek
h2o_temperature,location=santa_monica

该查询的输出类似行协议格式。第一个逗号之前的所有内容是measurement的名字。第一个逗号之后的所有内容都是tag key或者tag value。数据库NOAA_water_database有五个不同的measurement和14个不同的序列。

示例二:运行不带有ON子句的SHOW SERIES查询

使用USE <database_name>指定数据库

> USE NOAA_water_database
Using database NOAA_water_database

> SHOW SERIES

key
---
average_temperature,location=coyote_creek
average_temperature,location=santa_monica
h2o_feet,location=coyote_creek
h2o_feet,location=santa_monica
h2o_pH,location=coyote_creek
h2o_pH,location=santa_monica
h2o_quality,location=coyote_creek,randtag=1
h2o_quality,location=coyote_creek,randtag=2
h2o_quality,location=coyote_creek,randtag=3
h2o_quality,location=santa_monica,randtag=1
h2o_quality,location=santa_monica,randtag=2
h2o_quality,location=santa_monica,randtag=3
h2o_temperature,location=coyote_creek
h2o_temperature,location=santa_monica

使用参数db指定数据库

~# curl -G "http://localhost:8086/query?db=NOAA_water_database&pretty=true" --data-urlencode "q=SHOW SERIES"

{
    "results": [
        {
            "statement_id": 0,
            "series": [
                {
                    "columns": [
                        "key"
                    ],
                    "values": [
                        [
                            "average_temperature,location=coyote_creek"
                        ],
                        [
                            "average_temperature,location=santa_monica"
                        ],
                        [
                            "h2o_feet,location=coyote_creek"
                        ],
                        [
                            "h2o_feet,location=santa_monica"
                        ],
                        [
                            "h2o_pH,location=coyote_creek"
                        ],
                        [
                            "h2o_pH,location=santa_monica"
                        ],
                        [
                            "h2o_quality,location=coyote_creek,randtag=1"
                        ],
                        [
                            "h2o_quality,location=coyote_creek,randtag=2"
                        ],
                        [
                            "h2o_quality,location=coyote_creek,randtag=3"
                        ],
                        [
                            "h2o_quality,location=santa_monica,randtag=1"
                        ],
                        [
                            "h2o_quality,location=santa_monica,randtag=2"
                        ],
                        [
                            "h2o_quality,location=santa_monica,randtag=3"
                        ],
                        [
                            "h2o_temperature,location=coyote_creek"
                        ],
                        [
                            "h2o_temperature,location=santa_monica"
                        ]
                    ]
                }
            ]
        }
    ]
}

示例三:运行带有多个子句的SHOW SERIES查询

> SHOW SERIES ON NOAA_water_database FROM "h2o_quality" WHERE "location" = 'coyote_creek' LIMIT 2

key
---
h2o_quality,location=coyote_creek,randtag=1
h2o_quality,location=coyote_creek,randtag=2

该查询返回数据库NOAA_water_database中,与measurement h2o_quality和tag location = coyote_creek相关联的所有序列。LIMIT子句将返回的序列个数限制为2。

SHOW MEASUREMENTS

返回指定数据库的measurement。

语法

SHOW MEASUREMENTS [ON <database_name>] [WITH MEASUREMENT <regular_expression>] [WHERE <tag_key> <operator> ['<tag_value>' | <regular_expression>]] [LIMIT_clause] [OFFSET_clause]

语法描述

ON <database_name>是可选的。如果查询中没有包含ON <database_name>,您必须在CLI中使用USE <database_name>指定数据库,或者在HTTP API请求中使用参数db指定数据库。

WITH子句,WHERE子句,LIMIT子句和OFFSET子句是可选的。WHERE子句支持tag比较;在SHOW MEASUREMENTS查询中,field比较是无效的。

WHERE子句中支持的操作符:

=

等于

<>

不等于

!=

不等于

=~

匹配

!~

不匹配

请查阅数据探索章节获得关于LIMIT子句、OFFSET子句和正则表达式的介绍。

示例

示例一:运行带有ON子句的SHOW MEASUREMENTS查询

> SHOW MEASUREMENTS ON NOAA_water_database

name: measurements
name
----
average_temperature
h2o_feet
h2o_pH
h2o_quality
h2o_temperature

该查询返回数据库NOAA_water_database中的measurement。数据库NOAA_water_database有五个measurement:average_temperatureh2o_feeth2o_pHh2o_qualityh2o_temperature

示例二:运行不带有ON子句的SHOW MEASUREMENTS查询

使用USE <database_name>指定数据库

> USE NOAA_water_database
Using database NOAA_water_database

> SHOW MEASUREMENTS
name: measurements
name
----
average_temperature
h2o_feet
h2o_pH
h2o_quality
h2o_temperature

使用参数db指定数据库

~# curl -G "http://localhost:8086/query?db=NOAA_water_database&pretty=true" --data-urlencode "q=SHOW MEASUREMENTS"

{
  {
      "results": [
          {
              "statement_id": 0,
              "series": [
                  {
                      "name": "measurements",
                      "columns": [
                          "name"
                      ],
                      "values": [
                          [
                              "average_temperature"
                          ],
                          [
                              "h2o_feet"
                          ],
                          [
                              "h2o_pH"
                          ],
                          [
                              "h2o_quality"
                          ],
                          [
                              "h2o_temperature"
                          ]
                      ]
                  }
              ]
          }
      ]
  }

示例三:运行带有多个子句的SHOW MEASUREMENTS查询(i)

> SHOW MEASUREMENTS ON NOAA_water_database WITH MEASUREMENT =~ /h2o.*/ LIMIT 2 OFFSET 1

name: measurements
name
----
h2o_pH
h2o_quality

该查询返回数据库NOAA_water_database中名字以h2o开头的measurement。LIMIT子句将返回的measurement名字的个数限制为2,OFFSET子句将measurement h2o_feet跳过,从h2o_feet后的measurement开始输出。

示例四:运行带有多个子句的SHOW MEASUREMENTS查询(ii)

> SHOW MEASUREMENTS ON NOAA_water_database WITH MEASUREMENT =~ /h2o.*/ WHERE "randtag"  =~ /\d/

name: measurements
name
----
h2o_quality

该查询返回数据库NOAA_water_database中名字以h2o开头并且randtag的值包含一个整数的measurement。

SHOW TAG KEYS

返回指定数据库的tag key。

语法

SHOW TAG KEYS [ON <database_name>] [FROM_clause] [WHERE <tag_key> <operator> ['<tag_value>' | <regular_expression>]] [LIMIT_clause] [OFFSET_clause]

语法描述

ON <database_name>是可选的。如果查询中没有包含ON <database_name>,您必须在CLI中使用USE <database_name>指定数据库,或者在HTTP API请求中使用参数db指定数据库。

FROM子句和WHERE子句是可选的。WHERE子句支持tag比较;在SHOW TAG KEYS查询中,field比较是无效的。

WHERE子句中支持的操作符:

=

等于

<>

不等于

!=

不等于

=~

匹配

!~

不匹配

请查阅数据探索章节获得关于FROM子句、LIMIT子句、OFFSET子句和正则表达式的介绍。

示例

示例一:运行带有ON子句的SHOW TAG KEYS查询

> SHOW TAG KEYS ON "NOAA_water_database"

name: average_temperature
tagKey
------
location

name: h2o_feet
tagKey
------
location

name: h2o_pH
tagKey
------
location

name: h2o_quality
tagKey
------
location
randtag

name: h2o_temperature
tagKey
------
location

该查询返回数据库NOAA_water_database中的tag key。查询结果按measurement的名字进行分组;它展示了每个measurement都有一个名为location的tag key,并且,measurement h2o_quality还具有另外一个tag key randtag

示例二:运行不带有ON子句的SHOW TAG KEYS查询

使用USE <database_name>指定数据库

> USE NOAA_water_database
Using database NOAA_water_database

> SHOW TAG KEYS

name: average_temperature
tagKey
------
location

name: h2o_feet
tagKey
------
location

name: h2o_pH
tagKey
------
location

name: h2o_quality
tagKey
------
location
randtag

name: h2o_temperature
tagKey
------
location

使用参数db指定数据库

~# curl -G "http://localhost:8086/query?db=NOAA_water_database&pretty=true" --data-urlencode "q=SHOW TAG KEYS"

{
    "results": [
        {
            "statement_id": 0,
            "series": [
                {
                    "name": "average_temperature",
                    "columns": [
                        "tagKey"
                    ],
                    "values": [
                        [
                            "location"
                        ]
                    ]
                },
                {
                    "name": "h2o_feet",
                    "columns": [
                        "tagKey"
                    ],
                    "values": [
                        [
                            "location"
                        ]
                    ]
                },
                {
                    "name": "h2o_pH",
                    "columns": [
                        "tagKey"
                    ],
                    "values": [
                        [
                            "location"
                        ]
                    ]
                },
                {
                    "name": "h2o_quality",
                    "columns": [
                        "tagKey"
                    ],
                    "values": [
                        [
                            "location"
                        ],
                        [
                            "randtag"
                        ]
                    ]
                },
                {
                    "name": "h2o_temperature",
                    "columns": [
                        "tagKey"
                    ],
                    "values": [
                        [
                            "location"
                        ]
                    ]
                }
            ]
        }
    ]
}

示例三:运行带有多个子句的SHOW TAG KEYS查询

> SHOW TAG KEYS ON "NOAA_water_database" FROM "h2o_quality" LIMIT 1 OFFSET 1

name: h2o_quality
tagKey
------
randtag

该查询返回数据库NOAA_water_database中名为h2o_quality的measurement里的tag key。LIMIT子句将返回的tag key的个数限制为1,OFFSET子句将输出结果偏移一个。

SHOW TAG VALUES

返回数据库中指定tag key的tag value。

语法

SHOW TAG VALUES [ON <database_name>][FROM_clause] WITH KEY [ [<operator> "<tag_key>" | <regular_expression>] | [IN ("<tag_key1>","<tag_key2")]] [WHERE <tag_key> <operator> ['<tag_value>' | <regular_expression>]] [LIMIT_clause] [OFFSET_clause]

语法描述

ON <database_name>是可选的。如果查询中没有包含ON <database_name>,您必须在CLI中使用USE <database_name>指定数据库,或者在HTTP API请求中使用参数db指定数据库。

WITH子句是必须要有的,它支持指定一个tag key、一个正则表达式或多个tag key。

FROM子句、WHERE子句、LIMIT子句和OFFSET子句是可选的。WHERE子句支持tag比较;在SHOW TAG VALUES查询中,field比较是无效的。

WITH子句和WHERE子句中支持的操作符:

=

等于

<>

不等于

!=

不等于

=~

匹配

!~

不匹配

请查阅数据探索章节获得关于FROM子句、LIMIT子句、OFFSET子句和正则表达式的介绍。

示例

示例一:运行带有ON子句的SHOW TAG VALUES查询

> SHOW TAG VALUES ON "NOAA_water_database" WITH KEY = "randtag"

name: h2o_quality
key       value
---       -----
randtag   1
randtag   2
randtag   3

该查询返回数据库NOAA_water_database中的tag key randtag的所有tag value。SHOW TAG VALUES将查询结果按measurement的名字进行分组。

示例二:运行不带有ON子句的SHOW TAG VALUES查询

使用USE <database_name>指定数据库

> USE NOAA_water_database
Using database NOAA_water_database

> SHOW TAG VALUES WITH KEY = "randtag"

name: h2o_quality
key       value
---       -----
randtag   1
randtag   2
randtag   3

使用参数db指定数据库

~# curl -G "http://localhost:8086/query?db=NOAA_water_database&pretty=true" --data-urlencode 'q=SHOW TAG VALUES WITH KEY = "randtag"'

{
    "results": [
        {
            "statement_id": 0,
            "series": [
                {
                    "name": "h2o_quality",
                    "columns": [
                        "key",
                        "value"
                    ],
                    "values": [
                        [
                            "randtag",
                            "1"
                        ],
                        [
                            "randtag",
                            "2"
                        ],
                        [
                            "randtag",
                            "3"
                        ]
                    ]
                }
            ]
        }
    ]
}

示例三:运行带有多个子句的SHOW TAG VALUES查询

> SHOW TAG VALUES ON "NOAA_water_database" WITH KEY IN ("location","randtag") WHERE "randtag" =~ /./ LIMIT 3

name: h2o_quality
key        value
---        -----
location   coyote_creek
location   santa_monica
randtag    1

该查询从数据库NOAA_water_database的所有measurement中返回locationrandtag的tag value,并且返回的数据还需满足条件:randtag的tag value不为空。LIMIT子句将返回的tag value的个数限制为3。

SHOW FIELD KEYS

返回field key和field value的数据类型。

语法

SHOW FIELD KEYS [ON <database_name>] [FROM <measurement_name>]

语法描述

ON <database_name>是可选的。如果查询中没有包含ON <database_name>,您必须在CLI中使用USE <database_name>指定数据库,或者在HTTP API请求中使用参数db指定数据库。

FROM子句也是可选的。请查阅数据探索章节获得关于FROM子句的介绍。

说明

注释:在不同的shard,field的数据类型可以不同。如果您的field中有多个数据类型,那么SHOW FIELD KEYS按以下顺序返回不同类型的数据:float,integer,string,boolean。

示例

示例一:运行带有ON子句的SHOW FIELD KEYS查询

> SHOW FIELD KEYS ON "NOAA_water_database"

name: average_temperature
fieldKey            fieldType
--------            ---------
degrees             float

name: h2o_feet
fieldKey            fieldType
--------            ---------
level description   string
water_level         float

name: h2o_pH
fieldKey            fieldType
--------            ---------
pH                  float

name: h2o_quality
fieldKey            fieldType
--------            ---------
index               float

name: h2o_temperature
fieldKey            fieldType
--------            ---------
degrees             float

该查询返回数据库NOAA_water_database中每个measurement的field key以及对应的field value的数据类型。

示例二:运行不带有ON子句的SHOW FIELD KEYS查询

使用USE <database_name>指定数据库

> USE NOAA_water_database
Using database NOAA_water_database

> SHOW FIELD KEYS

name: average_temperature
fieldKey            fieldType
--------            ---------
degrees             float

name: h2o_feet
fieldKey            fieldType
--------            ---------
level description   string
water_level         float

name: h2o_pH
fieldKey            fieldType
--------            ---------
pH                  float

name: h2o_quality
fieldKey            fieldType
--------            ---------
index               float

name: h2o_temperature
fieldKey            fieldType
--------            ---------
degrees             float

使用参数db指定数据库

~# curl -G "http://localhost:8086/query?db=NOAA_water_database&pretty=true" --data-urlencode 'q=SHOW FIELD KEYS'

{
    "results": [
        {
            "statement_id": 0,
            "series": [
                {
                    "name": "average_temperature",
                    "columns": [
                        "fieldKey",
                        "fieldType"
                    ],
                    "values": [
                        [
                            "degrees",
                            "float"
                        ]
                    ]
                },
                {
                    "name": "h2o_feet",
                    "columns": [
                        "fieldKey",
                        "fieldType"
                    ],
                    "values": [
                        [
                            "level description",
                            "string"
                        ],
                        [
                            "water_level",
                            "float"
                        ]
                    ]
                },
                {
                    "name": "h2o_pH",
                    "columns": [
                        "fieldKey",
                        "fieldType"
                    ],
                    "values": [
                        [
                            "pH",
                            "float"
                        ]
                    ]
                },
                {
                    "name": "h2o_quality",
                    "columns": [
                        "fieldKey",
                        "fieldType"
                    ],
                    "values": [
                        [
                            "index",
                            "float"
                        ]
                    ]
                },
                {
                    "name": "h2o_temperature",
                    "columns": [
                        "fieldKey",
                        "fieldType"
                    ],
                    "values": [
                        [
                            "degrees",
                            "float"
                        ]
                    ]
                }
            ]
        }
    ]
}

示例三:运行带有FROM子句的SHOW FIELD KEYS查询

> SHOW FIELD KEYS ON "NOAA_water_database" FROM "h2o_feet"

name: h2o_feet
fieldKey            fieldType
--------            ---------
level description   string
water_level         float

该查询返回数据库NOAA_water_database中measurement h2o_feet里的fields key以及对应的field value的数据类型。

SHOW FIELD KEYS的常见问题

问题一:SHOW FIELD KEYS和field的类型差异

在同一个shard,field value的数据类型不能发生变化,但是在不同的shard,field的数据类型可以不同。SHOW FIELD KEYS遍历每个shard返回与field key相关联的所有数据类型。

示例

field all_the_types中存储了四个不同的数据类型:

> SHOW FIELD KEYS

name: mymeas
fieldKey        fieldType
--------        ---------
all_the_types   integer
all_the_types   float
all_the_types   string
all_the_types   boolean
注意

SHOW FIELD KEYS处理field的类型差异与SELECT语句不一样。请查阅FAQ相关章节获得更多相关信息。

InfluxDB® is a trademark registered by InfluxData, which is not affiliated with, and does not endorse, TSDB for InfluxDB®.