时序数据查询和分析简介

SQL语法示例如下所示。

• 查询和分析全部数据。

  *| SELECT * FROM "my_metric_store.prom" WHERE __name__ != '' 

• 针对指标 http_request_count，查询__labels__中'domain'值为www.example.com的数据，并对__value__字段进行求和计算。

  *| SELECT sum(__value__) FROM "my_metric_store.prom" WHERE __name__='http_request_count' and element_at(__labels__, 'domain')='www.example.com' 

• 针对指标 http_request_count，查询__labels__中 'domain'值为www.example.com的数据，并对__value__字段按小时粒度执行聚合求和计算。

  *| SELECT sum(__value__),date_trunc('hour', __time_nano__/1000000) as t
  FROM "my_metric_store.prom" 
  WHERE __name__='http_request_count' and element_at(__labels__, 'domain')='www.example.com'
  GROUP BY t
  ORDER BY t DESC

SQL语法相关说明如下所示。

• 时序数据的SQL语法与日志的SQL语法一致。更多信息，请参见分析语法。但在时序数据的SQL语法中，FROM的表名只能为{metrics_store_name}.prom，其中{metrics_store_name}为您已创建的MetricStore名称。

  说明

  请保留表名两端的双引号（''''）。

• __labels__可使用element_at()函数获取其中某个Key的值，例如element_at(__labels__, 'key')。

• 表结构请参见编码方式。

PromQL函数相当于UDTF，即返回一个表。

• promql_query(string)、promql_query_range(string, string)函数返回的表的结构如下表所示。

  字段名	字段类型	说明
  metric	varchar	时序名称。如果使用了Group By语法，那么该值可能为空。
  labels	map<varchar, varchar>	Labels信息，Map类型。
  time	bigint	时间。
  value	double	某个时间点对应的值。

  查询示例如下：

  • promql_query(string)函数

  • promql_query_range(string, string)函数

• promql_labels()、promql_labels(string)、promql_label_values(string)、promql_label_values(string, string)函数返回的表的结构如下表所示。

  字段	字段类型	说明
  label	varchar	Label Key

  查询示例如下：

  • promql_labels()函数

  • promql_labels(string)函数

  • promql_label_values(string)函数

  • promql_label_values(string, string)函数

• promql_series(string)函数返回的表的结构如下表所示。

  字段	字段类型	说明
  series	map<varchar, varchar>	时间序列

  查询示例如下：