Schema 查询

最近更新时间:2024-05-16 17:00:42

我的收藏
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
显示指定数据库中的所有分片