文档文档

使用 InfluxQL 探索您的模式

使用 InfluxQL SHOW 语句返回有关您的数据模式的信息。

示例数据

以下示例使用 示例数据集 中提供的数据。要运行示例查询并返回相同的结果,请按照为每个示例数据集提供的说明将数据写入您的 InfluxDB Clustered 数据库。

列出数据库中的 measurements

使用 SHOW MEASUREMENTS 列出您的 InfluxDB 数据库中的 measurements。

SHOW MEASUREMENTS

查看示例输出

列出包含特定标签键值对的 measurements

要仅返回具有特定标签键值对的 measurements,请包含一个带有标签键值对的 WHERE 子句来查询。

SHOW MEASUREMENTS WHERE room = 'Kitchen'

查看示例输出

列出与正则表达式匹配的 measurements

要仅返回名称与 正则表达式 匹配的 measurements,请包含一个 WITH 子句,将 MEASUREMENT 与正则表达式进行比较。

SHOW MEASUREMENTS WITH MEASUREMENT =~ /^home/

查看示例输出

列出 measurement 中的 field keys

使用 SHOW FIELD KEYS 返回 measurement 中的所有 field keys。包含一个 FROM 子句来指定 measurement。如果未指定 measurement,则查询返回数据库中的所有 field keys。

SHOW FIELD KEYS FROM home

查看示例输出

列出 measurement 中的 tag keys

使用 SHOW TAG KEYS 返回 measurement 中的所有 tag keys。包含一个 FROM 子句来指定 measurement。如果未指定 measurement,则查询返回数据库中的所有 tag keys。

SHOW TAG KEYS FROM home_actions

查看示例输出

列出包含特定标签键值对的 measurements 中的 tag keys

要返回包含特定标签键值对的 measurements 中的所有 tag keys,请包含一个带有要查询的标签键值对的 WHERE 子句。

SHOW TAG KEYS WHERE room = 'Kitchen'

查看示例输出

列出特定 tag key 的 tag values

使用 SHOW TAG VALUES 返回 measurement 中特定 tags 的所有值。

  • 包含一个 FROM 子句来指定要查询的一个或多个 measurements。
  • 使用 WITH 子句将 KEY 与要列出值的 tag keys 进行比较。
  • 使用 WHERE 子句将搜索限制在特定时间范围内(默认时间范围是最近一天)。
SHOW TAG VALUES FROM weather WITH KEY = location

包含一个 FROM 子句

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

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

查看示例输出

列出多个 tags 的 tag values

要返回多个特定 tag keys 的 tag values,请在 WITH 子句中使用 IN 运算符将 KEY 与 tag keys 列表进行比较。

SHOW TAG VALUES FROM home_actions WITH KEY IN ("level", "action")

查看示例输出

列出与正则表达式匹配的 tags 的 tag values

要仅从与正则表达式匹配的 tag keys 返回 tag values,请在您的 WITH 子句中使用正则表达式比较运算符将 KEY 与正则表达式进行比较。

SHOW TAG VALUES FROM home, home_actions WITH KEY =~ /oo/

查看示例输出

列出与特定标签键值对关联的 tag values

要列出与特定标签键值对关联的 tags 的 tag values

  • 使用 WITH 子句来识别要为其返回值的 tag keys。
  • 包含一个 WHERE 子句,用于标识要查询的标签键值对。

以下示例返回 room 标签值为 Kitchen 的点的 actionlevel 标签的 tag values。

SHOW TAG VALUES FROM home_actions WITH KEY IN ("action", "level") WHERE room = 'Kitchen'

查看示例输出


此页面是否对您有帮助?

感谢您的反馈!


Flux 的未来

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

阅读更多

InfluxDB 3 开源版本现已公开发布 Alpha 版

InfluxDB 3 开源版本现已可用于 Alpha 测试,根据 MIT 或 Apache 2 许可获得许可。

我们正在发布两个产品作为 Alpha 版本的一部分。

InfluxDB 3 Core,是我们的新开源产品。它是一个用于时间序列和事件数据的最新数据引擎。InfluxDB 3 Enterprise 是一个商业版本,它建立在 Core 的基础上,增加了历史查询能力、读取副本、高可用性、可扩展性和细粒度的安全性。

有关如何开始使用的更多信息,请查看