动态与公告

产品动态

公告

产品简介

产品概述

系统架构

应用场景

关键概念

实例类型与规格

购买指南

产品定价

购买实例

续费说明

欠费说明

退费说明

快速入门

连接并写入数据

操作指南

访问管理

管理实例

自动备份

系统监控

库管理

账号管理

管理安全组

外网访问

InfluxQL 兼容性

数据库管理

Schema 查询

数据类型

数据查询

InfluxQL 函数

客户端

SDK 参考

influx CLI 客户端

API 文档

History

Introduction

API Category

Making API Requests

Instance APIs

Database APIs

Data Types

Error Codes

实践教程

数据表定义推荐

接入 Grafana 服务

接入 Telegraf 服务

性能白皮书

测试环境

测试工具

写入性能测试

查询性能测试

常见问题

词汇表

CTSDB 政策

隐私政策

数据处理和安全协议

联系我们

Schema 查询

PDF

聚焦模式

字号

最后更新时间： 2025-04-29 23:07:14

SQL
含义
兼容性
语义
SHOW DATABASES
查询所有数据库
✅
SHOW DATABASES
SHOW SERIES

查询符合指定条件的时间序列数据
✅
执行语义：
SHOW SERIES [FROM_clause] [WHERE <tag_key> <operator> [ '<tag_value>' | <regular_expression>]] [LIMIT_clause] [OFFSET_clause] [ORDER BY ASC/DESC]
FROM_clause：必须参数，用于指定要查询的测量名称。语法为：FROM <measurement_name>。例如：FROM cpu_usage。
WHERE <tag_key> <operator> [ '<tag_value>' | <regular_expression> ]：可选参数，用于指定查询条件。其中，<tag_key>为标签名称，<operator>为比较运算符，<tag_value>或<regular_expression>为比较值。可以使用多个 WHERE 子句以 AND 或 OR 组合多个条件。例如：WHERE host='server1' AND region='us-west'。
LIMIT_clause：可选参数，用于指定查询结果的最大行数。语法为：LIMIT <n>，其中<n>为最大行数。例如：LIMIT 10。
OFFSET_clause：可选参数，用于指定查询结果的偏移量。语法为：OFFSET <n>，其中<n>
为偏移量。例如：OFFSET5。
ORDER BY ASC/DESC：可选参数，用于指定查询结果的排序方式。语法为：ORDER BY <field> ASC/DESC，其中<field>为要排序的字段名称，ASC表示升序，DESC表示降序。例如：ORDER BY time DESC。
执行示例：
SHOW SERIES FROM yottadb_partition_replicas_num_lzl where cluster_name = 'yottadb-capd-gz-dataplane6' ORDER BY ASC LIMIT 5 OFFSET 5

SHOW MEASUREMENTS

获取当前 InfluxDB 实例中所有可用的测量（measurement）名称

✅
执行语义：
SHOW MEASUREMENTS [WITH MEASUREMENT <operator> ['<measurement_name>' | <regular_expression>]][WHERE <tag_key> <operator> ['<tag_value>' | <regular_expression>]][LIMIT_clause] [OFFSET_clause] [ORDER BY ASC/DESC]
SHOW MEASUREMENTS：指定查询的目标是测量值。
WITH MEASUREMENT：可选参数，用于更精细地筛选测量值。您可以使用运算符（operator），测量值名称或正则表达式来指定筛选条件。
WHERE：可选参数，用于根据标签（tag）筛选测量值。您可以使用标签键（tag key）、运算符，标签值（tag value）或正则表达式来指定筛选条件。
LIMIT_clause：可选参数，用于限制查询结果的数量。
OFFSET_clause：可选参数，用于指定查询结果的偏移量。
ORDER BY ASC/DESC：可选参数，用于指定查询结果的排序方式。ASC 表示升序排列，DESC 表示降序排列。
查找所有名为 sensor_data 的测量值，其中标签 location 等于 room1，并且标签 sensor_type 匹配正则表达式/temperature/的结果。
SHOW MEASUREMENTS WITH MEASUREMENT = 'sensor_data' WHERE location = 'room1' AND sensor_type =~ /temperature/
SHOW TAG KEYS

查询 InfluxDB 数据库中标签键（tag key）的查询语句

✅
执行语义：
SHOW TAG KEYS [FROM_clause] [WHERE <tag_key> <operator> ['<tag_value>' | <regular_expression>]] [LIMIT_clause] [OFFSET_clause] [ORDER BY ASC/DESC] [SIMIT_clause] [SOFFSET_clause]
SHOW TAG KEYS：标识查询的目标是标签键。
FROM_clause：可选参数，用于指定查询的测量值。如果省略此参数，则将查询所有测量值的标签键。
WHERE：可选参数，用于根据标签（tag）筛选标签键。您可以使用标签键、运算符、标签值或正则表达式来指定筛选条件。
LIMIT_clause：可选参数，用于限制查询结果的数量。
OFFSET_clause：可选参数，用于指定查询结果的偏移量。
ORDER BY ASC/DESC：可选参数，用于指定查询结果的排序方式。ASC表示升序排列，DESC表示降序排列。
SIMIT_clause：可选参数，用于限制返回结果中每个标签键返回的标签值的数量。
SOFFSET_clause：可选参数，用于指定返回结果中每个标签键返回的标签值的偏移量。
执行示例：
该查询将返回包含cluster_name = 'yottadb-capd-gz-dataplane6'条件的测量值的所有标签键，并按字母顺序排列。结果集将限制为前5个标签键，并从第2个标签键开始返回。对于每个标签键，仅返回前两个标签值，并从第三个标签值开始返回。
SHOW TAG KEYS WHERE cluster_name = 'yottadb-capd-gz-dataplane6' ORDER BY ASC LIMIT 5 OFFSET 1 SLIMIT 2 SOFFSET 2
SHOW TAG VALUES

查询测量值的特定标签键的所有标签值

✅
执行语义：
SHOW TAG VALUES [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] [ORDER BY ASC/DESC] [S
IMIT_clause] [SOFFSET_clause]
与 SHOW TAG KEYS 相比，增加参数 WITH KEY，指定要检索标签值的标签键名称。
[<operator> "<tag_key>" | <regular_expression>]：可选参数，用于指定要检索标签值的标签键名称。您可以使用等于号(=)、不等于号(!=)、正则表达式或 IN 运算符来匹配标签键。如果省略此参数，则返回所有标签键的标签值。
[IN ("<tag_key1>","<tag_key2")]：可选参数，用于指定要检索标签值的标签键名称列表。如果省略此参数，则返回所有标签键的标签值。
[WHERE <tag_key> <operator> ['<tag_value>' | <regular_expression>]]：可选参数，用于指定过滤条件，只返回符合条件的标签值。您可以使用等于号(=)、不等于号(!=)、正则表达式、IN运算符、大于号(>)、小于号(<)、大于等于号(>=)或小于等于号(<=)来匹配标签值。如果省略此参数，则返回所有符合条件的标签值。
执行示例：
该查询将返回三个标签键（account_id、cluster_display_name 和 cluster_name）的所有标签值，按升序排序，并且每个标签键返回的标签值数量限制为2，每个标签键返回的标签值偏移量为1。此外，该查询还限制了返回结果集中的行数为8，并且从第二个标签值开始返回结果。
SHOW TAG VALUES WITH KEY IN (account_id, cluster_display_name, cluster_name) ORDER BY ASC LIMIT 8 OFFSET 1 SLIMIT 2 SOFFSET 1
SHOW FIELD KEYS

显示指定测量值的所有字段键。每个字段键都包括名称、数据类型和是否为标记字段的信息。
✅
执行语义：
SHOW FIELD KEYS [FROM <measurement_name>] [LIMIT_clause] [OFFSET_clause] 
[ORDER BY ASC/DESC] [SIMIT_clause] [SOFFSET_clause]
参数含义，请参照 SHOW MEASUREMENTS，其中：
SIMIT_clause：限制每个字段键返回的值的数量。
SOFFSET_clause：指定每个字段键返回的值的偏移量。
执行示例：
该查询语句将从 yottadb_partition_replicas_num 表中获取字段键，并按升序排序。然后，它将返回从第5行开始的4行结果。具体来说，它将返回第5行到第8行的结果，每行包含一个字段键。
SHOW FIELD KEYS FROM yottadb_partition_replicas_num ORDER BY ASC LIMIT 4 OFFSET 4
SHOW SERIES CARDINALITY
显示数据库中所有时序数据的数量，并支持按测量、标签键或标签值进行筛选和分组，以及限制返回结果的数量和偏移量。
✅
执行语义：
SHOW SERIES CARDINALITY [FROM <measurement_name>] [where_clause] [group_by_clause] [LIMIT_clause] [OFFSET_clause] [SIMIT_clause] [SOFFSET_clause]
FROM <measurement_name>：可选参数，指定要查询的测量名称。如果未指定，则将查询所有测量。
where_clause：可选参数，指定要筛选的标签键和标签值。格式为：WHERE <tag_key>='<tag_value>' [AND <tag_key>='<tag_value>']
group_by_clause：可选参数，按标签键对结果进行分组。格式为：GROUP BY <tag_key>
LIMIT_clause：可选参数，限制返回的结果数。格式为：LIMIT <limit>
OFFSET_clause：可选参数，从结果集的指定偏移量之后开始返回结果。OFFSET <offset>
SIMIT_clause：可选参数，限制每个分组返回的结果数。格式为：SLIMIT <slimit>
SIMIT_clause：可选参数，从每个分组的指定偏移量之后开始返回结果。格式为：SOFFSET <soffset>
执行示例：
该示例将从 cpu_usage 测量中获取所有标签 region 为 us-west、host为 server-1的时序数据，并按标签 cpu_type 进行分组。它还将限制返回的结果数为10，从第 21 行开始返回结果，并限制每个分组返回的结果数为5，从每个分组的第3行开始返回结果。
SHOW SERIES CARDINALITY FROM cpu_usage WHERE region='us-west' AND host='server-1' GROUP BY cpu_type LIMIT 10 OFFSET 20 SLIMIT 5 SOFFSET 2
﻿
SHOW FIELD KEY CARDINALITY
显示数据库中所有测量的字段键数量
❌
-
SHOW MEASUREMENT CARDINALITY
显示数据库中所有测量的数量
❌
-
SHOW TAG KEY CARDINALITY
显示数据库中所有测量的标签键数量
❌
-
SHOW TAG VALUES CARDINALITY
显示数据库中指定标签键的标签值数量
❌
﻿
SHOW RETENTION  POLICIES
显示指定数据库中的保留策略
❌
﻿
SHOW SHARDS
显示指定数据库中的所有分片
❌
﻿

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

tencent cloud

时序数据库 CTSDB

Schema 查询

帮助和支持

SQL	含义	兼容性	语义
SHOW DATABASES	查询所有数据库	✅	SHOW DATABASES
SHOW SERIES	查询符合指定条件的时间序列数据	✅	执行语义： `SHOW SERIES [FROM_clause] [WHERE <tag_key> <operator> [ '<tag_value>' \| <regular_expression>]] [LIMIT_clause] [OFFSET_clause] [ORDER BY ASC/DESC]` FROM_clause：必须参数，用于指定要查询的测量名称。语法为：FROM <measurement_name>。例如：FROM cpu_usage。 WHERE <tag_key> <operator> [ '<tag_value>' \| <regular_expression> ]：可选参数，用于指定查询条件。其中，<tag_key>为标签名称，<operator>为比较运算符，<tag_value>或<regular_expression>为比较值。可以使用多个 WHERE 子句以 AND 或 OR 组合多个条件。例如：WHERE host='server1' AND region='us-west'。 LIMIT_clause：可选参数，用于指定查询结果的最大行数。语法为：LIMIT <n>，其中<n>为最大行数。例如：LIMIT 10。 OFFSET_clause：可选参数，用于指定查询结果的偏移量。语法为：OFFSET <n>，其中<n> 为偏移量。例如：OFFSET5。 ORDER BY ASC/DESC：可选参数，用于指定查询结果的排序方式。语法为：ORDER BY <field> ASC/DESC，其中<field>为要排序的字段名称，ASC表示升序，DESC表示降序。例如：ORDER BY time DESC。执行示例： `SHOW SERIES FROM yottadb_partition_replicas_num_lzl where cluster_name = 'yottadb-capd-gz-dataplane6' ORDER BY ASC LIMIT 5 OFFSET 5`
SHOW MEASUREMENTS	获取当前 InfluxDB 实例中所有可用的测量（measurement）名称	✅	执行语义： `SHOW MEASUREMENTS [WITH MEASUREMENT <operator> ['<measurement_name>' \| <regular_expression>]][WHERE <tag_key> <operator> ['<tag_value>' \| <regular_expression>]][LIMIT_clause] [OFFSET_clause] [ORDER BY ASC/DESC]` SHOW MEASUREMENTS：指定查询的目标是测量值。 WITH MEASUREMENT：可选参数，用于更精细地筛选测量值。您可以使用运算符（operator），测量值名称或正则表达式来指定筛选条件。 WHERE：可选参数，用于根据标签（tag）筛选测量值。您可以使用标签键（tag key）、运算符，标签值（tag value）或正则表达式来指定筛选条件。 LIMIT_clause：可选参数，用于限制查询结果的数量。 OFFSET_clause：可选参数，用于指定查询结果的偏移量。 ORDER BY ASC/DESC：可选参数，用于指定查询结果的排序方式。ASC 表示升序排列，DESC 表示降序排列。查找所有名为 sensor_data 的测量值，其中标签 location 等于 room1，并且标签 sensor_type 匹配正则表达式/temperature/的结果。 `SHOW MEASUREMENTS WITH MEASUREMENT = 'sensor_data' WHERE location = 'room1' AND sensor_type =~ /temperature/`
SHOW TAG KEYS	查询 InfluxDB 数据库中标签键（tag key）的查询语句	✅	执行语义： `SHOW TAG KEYS [FROM_clause] [WHERE <tag_key> <operator> ['<tag_value>' \| <regular_expression>]] [LIMIT_clause] [OFFSET_clause] [ORDER BY ASC/DESC] [SIMIT_clause] [SOFFSET_clause]` SHOW TAG KEYS：标识查询的目标是标签键。 FROM_clause：可选参数，用于指定查询的测量值。如果省略此参数，则将查询所有测量值的标签键。 WHERE：可选参数，用于根据标签（tag）筛选标签键。您可以使用标签键、运算符、标签值或正则表达式来指定筛选条件。 LIMIT_clause：可选参数，用于限制查询结果的数量。 OFFSET_clause：可选参数，用于指定查询结果的偏移量。 ORDER BY ASC/DESC：可选参数，用于指定查询结果的排序方式。ASC表示升序排列，DESC表示降序排列。 SIMIT_clause：可选参数，用于限制返回结果中每个标签键返回的标签值的数量。 SOFFSET_clause：可选参数，用于指定返回结果中每个标签键返回的标签值的偏移量。执行示例：该查询将返回包含`cluster_name = 'yottadb-capd-gz-dataplane6'`条件的测量值的所有标签键，并按字母顺序排列。结果集将限制为前5个标签键，并从第2个标签键开始返回。对于每个标签键，仅返回前两个标签值，并从第三个标签值开始返回。 `SHOW TAG KEYS WHERE cluster_name = 'yottadb-capd-gz-dataplane6' ORDER BY ASC LIMIT 5 OFFSET 1 SLIMIT 2 SOFFSET 2`
SHOW TAG VALUES	查询测量值的特定标签键的所有标签值	✅	执行语义： `SHOW TAG VALUES [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] [ORDER BY ASC/DESC] [S IMIT_clause] [SOFFSET_clause]` 与 SHOW TAG KEYS 相比，增加参数 WITH KEY，指定要检索标签值的标签键名称。 [<operator> "<tag_key>" \| <regular_expression>]：可选参数，用于指定要检索标签值的标签键名称。您可以使用等于号(=)、不等于号(!=)、正则表达式或 IN 运算符来匹配标签键。如果省略此参数，则返回所有标签键的标签值。 [IN ("<tag_key1>","<tag_key2")]：可选参数，用于指定要检索标签值的标签键名称列表。如果省略此参数，则返回所有标签键的标签值。 [WHERE <tag_key> <operator> ['<tag_value>' \| <regular_expression>]]：可选参数，用于指定过滤条件，只返回符合条件的标签值。您可以使用等于号(=)、不等于号(!=)、正则表达式、IN运算符、大于号(>)、小于号(<)、大于等于号(>=)或小于等于号(<=)来匹配标签值。如果省略此参数，则返回所有符合条件的标签值。执行示例：该查询将返回三个标签键（account_id、cluster_display_name 和 cluster_name）的所有标签值，按升序排序，并且每个标签键返回的标签值数量限制为2，每个标签键返回的标签值偏移量为1。此外，该查询还限制了返回结果集中的行数为8，并且从第二个标签值开始返回结果。 `SHOW TAG VALUES WITH KEY IN (account_id, cluster_display_name, cluster_name) ORDER BY ASC LIMIT 8 OFFSET 1 SLIMIT 2 SOFFSET 1`
SHOW FIELD KEYS	显示指定测量值的所有字段键。每个字段键都包括名称、数据类型和是否为标记字段的信息。	✅	执行语义： `SHOW FIELD KEYS [FROM <measurement_name>] [LIMIT_clause] [OFFSET_clause] [ORDER BY ASC/DESC] [SIMIT_clause] [SOFFSET_clause]` 参数含义，请参照 SHOW MEASUREMENTS，其中： SIMIT_clause：限制每个字段键返回的值的数量。 SOFFSET_clause：指定每个字段键返回的值的偏移量。执行示例：该查询语句将从 yottadb_partition_replicas_num 表中获取字段键，并按升序排序。然后，它将返回从第5行开始的4行结果。具体来说，它将返回第5行到第8行的结果，每行包含一个字段键。 `SHOW FIELD KEYS FROM yottadb_partition_replicas_num ORDER BY ASC LIMIT 4 OFFSET 4`
SHOW SERIES CARDINALITY	显示数据库中所有时序数据的数量，并支持按测量、标签键或标签值进行筛选和分组，以及限制返回结果的数量和偏移量。	✅	执行语义： `SHOW SERIES CARDINALITY [FROM <measurement_name>] [where_clause] [group_by_clause] [LIMIT_clause] [OFFSET_clause] [SIMIT_clause] [SOFFSET_clause]` FROM <measurement_name>：可选参数，指定要查询的测量名称。如果未指定，则将查询所有测量。 where_clause：可选参数，指定要筛选的标签键和标签值。格式为：`WHERE <tag_key>='<tag_value>' [AND <tag_key>='<tag_value>']` group_by_clause：可选参数，按标签键对结果进行分组。格式为：`GROUP BY <tag_key>` LIMIT_clause：可选参数，限制返回的结果数。格式为：`LIMIT <limit>` OFFSET_clause：可选参数，从结果集的指定偏移量之后开始返回结果。`OFFSET <offset>` SIMIT_clause：可选参数，限制每个分组返回的结果数。格式为：`SLIMIT <slimit>` SIMIT_clause：可选参数，从每个分组的指定偏移量之后开始返回结果。格式为：`SOFFSET <soffset>` 执行示例：该示例将从 cpu_usage 测量中获取所有标签 region 为 us-west、host为 server-1的时序数据，并按标签 cpu_type 进行分组。它还将限制返回的结果数为10，从第 21 行开始返回结果，并限制每个分组返回的结果数为5，从每个分组的第3行开始返回结果。 `SHOW SERIES CARDINALITY FROM cpu_usage WHERE region='us-west' AND host='server-1' GROUP BY cpu_type LIMIT 10 OFFSET 20 SLIMIT 5 SOFFSET 2`
SHOW FIELD KEY CARDINALITY	显示数据库中所有测量的字段键数量	❌	-
SHOW MEASUREMENT CARDINALITY	显示数据库中所有测量的数量	❌	-
SHOW TAG KEY CARDINALITY	显示数据库中所有测量的标签键数量	❌	-
SHOW TAG VALUES CARDINALITY	显示数据库中指定标签键的标签值数量	❌
SHOW RETENTION POLICIES	显示指定数据库中的保留策略	❌
SHOW SHARDS	显示指定数据库中的所有分片	❌