使用 InfluxQL 探索您的模式
使用 InfluxQL SHOW 语句返回有关您的数据模式的信息。
InfluxDB v1 到 InfluxDB 3 数据模型
InfluxQL 是围绕 InfluxDB v1 数据模型设计的，但仍然可以用于查询 InfluxDB 3 Core 中的数据。当使用 InfluxDB 3 Core InfluxQL 实现时，数据模型在以下方面有所不同：
- InfluxDB v1 的数据库和保留策略组合被合并为一个 InfluxDB 3 数据库实体。
- InfluxDB v1 的measurement 等同于 InfluxDB 3 的 table。
示例数据
以下示例使用示例数据集中提供的数据。要运行示例查询并返回相同的结果，请按照为每个示例数据集提供的说明将数据写入您的 InfluxDB 3 Core 数据库。
列出数据库中的 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 中的字段键
使用 SHOW FIELD KEYS 返回 measurement 中的所有字段键。包含 FROM 子句以指定 measurement。如果未指定 measurement，则查询返回数据库中的所有字段键。
SHOW FIELD KEYS FROM home
列出 measurement 中的标签键
使用 SHOW TAG KEYS 返回 measurement 中的所有标签键。包含 FROM 子句以指定 measurement。如果未指定 measurement，则查询返回数据库中的所有标签键。
SHOW TAG KEYS FROM home_actions
列出包含特定标签键值对的 measurements 中的标签键
要返回包含特定标签键值对的 measurements 中的所有标签键，请包含 WHERE 子句以及要查询的标签键值对。
SHOW TAG KEYS WHERE room = 'Kitchen'
列出特定标签键的标签值
使用 SHOW TAG VALUES 返回 measurement 中特定标签的所有值。
- 包含
FROM子句以指定要查询的一个或多个 measurements。 - 使用
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 的点的 action 和 level 标签的标签值。
SHOW TAG VALUES FROM home_actions WITH KEY IN ("action", "level") WHERE room = 'Kitchen'
此页面是否对您有帮助？
感谢您的反馈！
支持和反馈
感谢您成为我们社区的一份子！我们欢迎并鼓励您提供关于 InfluxDB 3 Core 和本文档的反馈和错误报告。要获得支持，请使用以下资源：
拥有年度合同或支持合同的客户可以联系 InfluxData 支持。