Schema探索

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

SHOW DATABASES	SHOW RETENTION POLICIES	SHOW SERIES
SHOW MEASUREMENTS	SHOW TAG KEYS	SHOW TAG VALUES
SHOW FIELD KEYS	Filter meta queries by time

**示例数据**

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

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

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

`SHOW DATABASES`

返回实例上所有数据库的列表。

语法

SHOW DATABASES

示例

运行 `SHOW DATABASES` 查询语句

> SHOW DATABASES

name: databases
name
----
NOAA_water_database
_internal

该查询以表格格式返回数据库名称，这个InfluxDB实例有两个数据库：NOAA_water_database和_internal。

`SHOW RETENTION POLICIES`

返回指定数据库的保留策略列表。

语法

SHOW RETENTION POLICIES [ON <database_name>]

语法说明

ON <database_name>是可选项。如果查询中没有包含ON <database_name>，您必须在CLI中使用USE <database_name>指定数据库，或者在InfluxDB 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`查询

CLI InfluxDB API

使用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>指定数据库，或者在InfluxDB API请求中使用参数db指定数据库。

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

WHERE子句中支持的操作符：

操作符	含义
`=`	等于
`<>`	不等于
`!=`	不等于
`=~`	匹配
`!~`	不匹配

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

示例

运行带有`ON`子句的`SHOW SERIES`查询

// Returns series for all shards in the database
> 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`查询

CLI InfluxDB API

使用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 SERIES`查询

在指定的分片组持续时间内返回系列。

// 返回当前分片中的所有系列
> SHOW SERIES ON NOAA_water_database WHERE time > now() - 1m

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

上面的查询返回当前分片组中数据库NOAA_water_database中的所有系列。WHERE子句将结果限制为shard组中包含最后一分钟时间戳的系列。注意，如果分片组持续时间为7天，则返回的结果可能最长为7天。

// 返回分片组中时间戳包含过去28天的所有系列
> SHOW SERIES ON NOAA_water_database WHERE time > now() - 28d

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

注意，如果指定分片持续时间为7天，则上面的查询将返回最后3或4个分片的系列。

`SHOW MEASUREMENTS`

返回指定数据库的measurement。

语法

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

语法描述

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_temperature、h2o_feet、h2o_pH、h2o_quality和h2o_temperature。

运行不带有`ON`子句的`SHOW MEASUREMENTS`查询

CLI InfluxDB API

使用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]

语法描述

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`查询

CLI InfluxDB API

使用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`查询

CLI InfluxDB API

使用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中返回location或randtag的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>]

语法描述

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`查询

CLI InfluxDB API

使用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语句不一样。有关更多信息，请参阅InfluxDB如何处理各个分片之间的字段类型差异？

按时间过滤元查询

当您按时间过滤元查询时，您可能会看到超出指定时间的结果。元查询结果在分片级别进行过滤，因此结果的粒度与分片组的持续时间大致相同。如果您的时间过滤器跨越多个分片，您将获得所有分片的结果，这些分片在指定的时间范围内。要查看分片上的分片和时间戳，请运行SHOW SHARDS。要了解有关分片及其持续时间的更多信息，请参阅建议的分片组持续时间。

下面的示例显示了如何SHOW TAG KEYS使用1h分片组持续时间过滤大约一小时。要过滤其他元数据，替换SHOW TAG KEYS与SHOW TAG VALUES，SHOW SERIES，SHOW FIELD KEYS，等等。

注意： SHOW MEASUREMENTS无法按时间过滤。

`SHOW TAG KEYS`按时间过滤的示例

在新数据库上指定分片持续时间或更改现有的分片持续时间。要在创建新数据库时指定1h的分片持续时间，请运行以下命令：
```
> CREATE database mydb with duration 7d REPLICATION 1 SHARD DURATION 1h name myRP;.
```
**注意：**最小分片持续时间为1h。

通过运行SHOW SHARDS命令验证分片持续时间是否具有正确的时间间隔（精度）。下面的示例显示了一个小时精度的分片持续时间。

> SHOW SHARDS
name: mydb
id database retention_policy shard_group start_time end_time expiry_time owners
-- -------- ---------------- ----------- ---------- -------- ----------- ------
> precision h

（可选）插入样本标签键。此步骤仅用于演示目的。如果您已经有tag key（或其他元数据）要搜索，请跳过此步骤。

// 将样本tag为"test_key"插入到measurement"test"中，然后检查时间戳：
> INSERT test,test_key=hello value=1

> select * from test
name: test
time test_key value
---- -------- -----
434820 hello 1

// 添加时间戳分别为1h，2h,3h的新tag key

> INSERT test,test_key_1=hello value=1 434819
> INSERT test,test_key_2=hello value=1 434819
> INSERT test,test_key_3_=hello value=1 434818
> INSERT test,test_key_4=hello value=1 434817
> INSERT test,test_key_5_=hello value=1 434817

分片时间范围内查找tag key，请运行以下命令：

SHOW TAG KEYS ON database-name <WHERE time clause> 或SELECT * FROM measurement <WHERE time clause>

下面步骤使用步骤3中的测试数据。

// 使用步骤3中的数据，显示当前时间到一个小时前的tag key
> SHOW TAG KEYS ON mydb where time > now() -1h and time < now()
name: test
tagKey
------
test_key
test_key_1
test_key_2

// 查找一个小时前到两个小时前的tag key
> SHOW TAG KEYS ON mydb where > time > now() -2h and time < now()-1h
name: test
tagKey
------
test_key_1
test_key_2
test_key_3

// 查找2个小时前到三个小时前的tag key
> SHOW TAG KEYS ON mydb where > time > now() -3h and time < now()-2h
name: test
tagKey
------
test_key_3
test_key_4
test_key_5

// 对于指定的measurement，通过指定分片的时间范围来查找给定分片中的tag key
> SELECT * FROM test WHERE time >= '2019-08-09T00:00:00Z' and time < '2019-08-09T10:00:00Z'
name: test
time test_key_4 test_key_5 value
---- ------------ ------------ -----
434817 hello 1
434817 hello 1

// 对于指定的数据库，通过指定分片的时间范围来查找给定分片中的tag key
> SHOW TAG KEYS ON mydb WHERE time >= '2019-08-09T00:00:00Z' and time < '2019-08-09T10:00:00Z'
name: test
tagKey
------
test_key_4
test_key_5

支持与反馈

欢迎来到我们这个大家庭！如对于InfluxDB产品和文档有任何反馈，请关注下列信息：

文档有问题？提Issue

Schema探索

SHOW DATABASES

语法

示例

运行 SHOW DATABASES 查询语句

SHOW RETENTION POLICIES

语法

语法说明

示例

运行带有ON子句的SHOW RETENTION POLICIES查询

运行不带有ON子句的SHOW RETENTION POLICIES查询

SHOW SERIES

语法

语法描述

示例

运行带有ON子句的SHOW SERIES查询

运行不带有ON子句的SHOW SERIES查询

运行带有多个子句的SHOW SERIES查询

运行带有时间限制的SHOW SERIES查询

SHOW MEASUREMENTS

语法

语法描述

示例

运行带有ON子句的SHOW MEASUREMENTS查询

运行不带有ON子句的SHOW MEASUREMENTS查询

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

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

SHOW TAG KEYS

语法

语法描述

示例

运行带有ON子句的SHOW TAG KEYS查询

运行不带有ON子句的SHOW TAG KEYS查询

运行带有多个子句的SHOW TAG KEYS查询

SHOW TAG VALUES

语法

语法描述

示例

运行带有ON子句的SHOW TAG VALUES查询

运行不带有ON子句的SHOW TAG VALUES查询

运行带有多个子句的SHOW TAG VALUES查询

SHOW FIELD KEYS

语法

语法描述

示例

运行带有ON子句的SHOW FIELD KEYS查询

运行不带有ON子句的SHOW FIELD KEYS查询

运行带有FROM子句的SHOW FIELD KEYS查询

SHOW FIELD KEYS的常见问题

SHOW FIELD KEYS和field的类型差异

示例

按时间过滤元查询

SHOW TAG KEYS按时间过滤的示例

支持与反馈

Where are you running InfluxDB?

InfluxDB OSS

Default

Custom

InfluxDB Cloud

AWS

GCP

Azure

InfluxDB OSS 2.0 release candidate

`SHOW DATABASES`

运行 `SHOW DATABASES` 查询语句

`SHOW RETENTION POLICIES`

运行带有`ON`子句的`SHOW RETENTION POLICIES`查询

运行不带有`ON`子句的`SHOW RETENTION POLICIES`查询

`SHOW SERIES`

运行带有`ON`子句的`SHOW SERIES`查询

运行不带有`ON`子句的`SHOW SERIES`查询

运行带有多个子句的`SHOW SERIES`查询

运行带有时间限制的`SHOW SERIES`查询

`SHOW MEASUREMENTS`

运行带有`ON`子句的`SHOW MEASUREMENTS`查询

运行不带有`ON`子句的`SHOW MEASUREMENTS`查询

运行带有多个子句的`SHOW MEASUREMENTS查询`(i)

运行带有多个子句的`SHOW MEASUREMENTS`查询(ii)

`SHOW TAG KEYS`

运行带有`ON`子句的`SHOW TAG KEYS`查询

运行不带有`ON`子句的`SHOW TAG KEYS`查询

运行带有多个子句的`SHOW TAG KEYS`查询

`SHOW TAG VALUES`

运行带有`ON`子句的`SHOW TAG VALUES`查询

运行不带有`ON`子句的`SHOW TAG VALUES`查询

运行带有多个子句的`SHOW TAG VALUES`查询

`SHOW FIELD KEYS`

运行带有`ON`子句的`SHOW FIELD KEYS`查询

运行不带有`ON`子句的`SHOW FIELD KEYS`查询

运行带有`FROM`子句的`SHOW FIELD KEYS`查询

`SHOW FIELD KEYS`的常见问题

`SHOW FIELD KEYS`和field的类型差异

`SHOW TAG KEYS`按时间过滤的示例