文档文档

InfluxQL SHOW 语句

使用 InfluxQL SHOW 语句从数据库查询模式信息。

SHOW RETENTION POLICIES

使用 SHOW RETENTION POLICIES 语句列出与数据库关联的保留策略。每个数据库都有一个保留策略 – autogen

在 InfluxDB 3 Core 中,保留策略不是数据结构的一部分,而是 InfluxQL 期望的,并在 FROM 子句 中的完全限定的度量中使用。为每个保留策略返回的数据不代表数据库的实际保留相关属性。这些值是占位符值,仅用于 InfluxQL 功能对等。

有关数据库数据保留的信息,请参阅列出数据库

SHOW RETENTION POLICIES [ON <database-name>]

示例

-- Show retention policies in the database specified in the query request
SHOW RETENTION POLICIES

-- Show retention policies in a specific database
SHOW RETENTION POLICIES ON "example-database"

SHOW MEASUREMENTS

使用 SHOW MEASUREMENTS 语句列出数据库中的度量。

SHOW MEASUREMENTS [with_measurement_clause] [where_clause] [limit_clause] [offset_clause]

示例

-- Show all measurements
SHOW MEASUREMENTS

-- Show measurements where region tag = 'uswest' AND host tag = 'serverA'
SHOW MEASUREMENTS WHERE "region" = 'uswest' AND "host" = 'serverA'

-- Show measurements that start with 'h2o'
SHOW MEASUREMENTS WITH MEASUREMENT =~ /h2o.*/

SHOW FIELD KEYS

使用 SHOW FIELD KEYS 语句列出度量中的所有字段键。

SHOW FIELD KEYS [from_clause]

示例

-- Show field keys and field value data types from all measurements
SHOW FIELD KEYS

-- Show field keys and field value data types from specified measurement
SHOW FIELD KEYS FROM "cpu"

SHOW TAG KEYS

使用 SHOW TAG KEYS 语句列出度量中的标签键。

SHOW TAG KEYS [from_clause] [where_clause] [limit_clause] [offset_clause]

示例

-- Show all tag keys
SHOW TAG KEYS

-- Show all tag keys from the cpu measurement
SHOW TAG KEYS FROM "cpu"

-- Show all tag keys from the cpu measurement where the region key = 'uswest'
SHOW TAG KEYS FROM "cpu" WHERE "region" = 'uswest'

-- Show all tag keys where the host key = 'serverA'
SHOW TAG KEYS WHERE "host" = 'serverA'

SHOW TAG VALUES

使用 SHOW TAG VALUES 语句列出数据库中指定标签的值。

SHOW TAG VALUES [from_clause] WITH KEY = <tag-expression> [where_clause] [limit_clause] [offset_clause]

默认情况下,SHOW TAG VALUES 语句仅返回最近一天的唯一标签值。要修改时间范围,请包含带有基于时间的谓词的 WHERE 子句

包含 FROM 子句

我们强烈建议在 SHOW TAG VALUES 语句中包含 FROM 子句,以指定要查询的 1-50 个表。如果没有 FROM 子句,InfluxDB 查询引擎必须从所有表中读取数据,并从每个表返回唯一的标签值。

根据数据库中表的数量以及每个表中唯一标签值的数量,排除 FROM 子句可能会导致查询性能不佳、查询超时或不必要的资源分配,这可能会影响其他查询。

示例

-- Show tag values from the cpu measurement for the region tag
SHOW TAG VALUES FROM "cpu" WITH KEY = "region"

-- Show tag values from the cpu measurement for the region tag for a custom time range
SHOW TAG VALUES FROM "cpu" WITH KEY = "region" WHERE time > -7d

-- Show tag values from multiple measurements for the region tag
SHOW TAG VALUES FROM "cpu", "memory", "disk" WITH KEY = "region"

-- Show tag values from the cpu measurement for all tag keys that do not include the letter c
SHOW TAG VALUES FROM "cpu" WITH KEY !~ /.*c.*/

-- Show tag values from the cpu measurement for region & host tag keys where service = 'redis'
SHOW TAG VALUES FROM "cpu" WITH KEY IN ("region", "host") WHERE "service" = 'redis'

此页是否对您有帮助?

感谢您的反馈!


Flux 的未来

Flux 即将进入维护模式。您可以继续像目前一样使用它,而无需对您的代码进行任何更改。

阅读更多

现已全面上市

InfluxDB 3 Core 和 Enterprise

快速启动。更快扩展。

获取更新

InfluxDB 3 Core 是一个开源、高速、近实时数据引擎,可实时收集和处理数据,并将其持久化到本地磁盘或对象存储。InfluxDB 3 Enterprise 构建在 Core 的基础上,增加了高可用性、读取副本、增强的安全性以及数据压缩,以实现更快的查询和优化的存储。InfluxDB 3 Enterprise 的免费层可供非商业家庭或业余爱好者使用。

有关更多信息,请查看