文档

使用 InfluxQL 探索您的模式

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

样本数据

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

列出数据库中的测量值

使用 SHOW MEASUREMENTS 列出 InfluxDB 数据库中的测量值。

SHOW MEASUREMENTS

查看示例输出

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

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

SHOW MEASUREMENTS WHERE room = 'Kitchen'

查看示例输出

列出匹配正则表达式的测量值

要返回与正则表达式匹配的名称的测量值,请在查询中包含一个 WITH 子句,该子句将 MEASUREMENT 与正则表达式进行比较。

SHOW MEASUREMENTS WITH MEASUREMENT =~ /^home/

查看示例输出

列出测量值中的字段键

使用 SHOW FIELD KEYS 返回测量中的所有字段键。包含一个 FROM 子句以指定测量值。如果未指定测量值,查询将返回数据库中的所有字段键。

SHOW FIELD KEYS FROM home

查看示例输出

列出测量值中的标签键

使用 SHOW TAG KEYS 返回测量中的所有标签键。包含一个 FROM 子句以指定测量值。如果未指定测量值,查询将返回数据库中的所有标签键。

SHOW TAG KEYS FROM home_actions

查看示例输出

列出包含特定标签键值对的测量值中的标签键

要返回包含特定标签键值对的标签键测量值,请包含一个包含要查询的标签键值对的 WHERE 子句。

SHOW TAG KEYS WHERE room = 'Kitchen'

查看示例输出

列出特定标签键的标签值

使用 SHOW TAG VALUES 返回测量中特定标签的所有值。

  • 包含一个 FROM 子句以指定一个或多个要查询的测量值。
  • 使用 WITH 子句将 KEY 与标签键进行比较以列出值。
  • 使用 WHERE 子句将搜索范围限制在特定的日期范围内(默认日期范围是最后一天)。
SHOW TAG VALUES FROM weather WITH KEY = location

包含一个 FROM 子句

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

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

查看示例输出

列出多个标签的标签值

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

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

查看示例输出

列出匹配正则表达式的标签值

要返回与正则表达式匹配的标签键的标签值,请在 WITH 子句中使用正则表达式比较运算符将 KEY 与正则表达式进行比较。

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

查看示例输出

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

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

  • 使用 WITH 子句以标识要返回值的标签键。
  • 包含一个 WHERE 子句以标识要查询的标签键值对。

以下示例返回当 room 标签值为 Kitchen 时,actionlevel 标签的标签值。

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

查看示例输出


这个页面有帮助吗?

感谢您的反馈!


Flux 的未来

Flux 正进入维护模式。您可以在不修改现有代码的情况下继续使用它。

阅读更多

InfluxDB v3 增强功能和 InfluxDB 集群版现已全面上市

新功能包括更快的查询性能和管理工具,推动了 InfluxDB v3 产品线的进步。InfluxDB 集群版现已全面上市。

InfluxDB v3 性能和功能

InfluxDB v3 产品线在查询性能方面取得了显著提升,并提供了新的管理工具。这些增强功能包括用于监控 InfluxDB 集群健康的操作仪表板、InfluxDB 云专用版中的单点登录(SSO)支持以及用于令牌和数据库的新管理 API。

了解新的 v3 增强功能


InfluxDB 集群版全面上市

InfluxDB 集群版现已全面上市,为您的自管理堆栈提供了 InfluxDB v3 的功能。

与我们谈谈 InfluxDB 集群版