语法
参数
db_name- TimeSeries 表所在的数据库名称。time_series_table- TimeSeries 表的名称。promql_query- 按 PromQL 语法 编写的查询。start_time- 评估范围的起始时间。end_time- 评估范围的结束时间。step- 用于将评估时间从start_time逐步推进到end_time(含两端) 的步长。
返回值
promql_query 的查询结果类型，返回不同的列：
| 结果类型 | 结果列 | 示例 |
|---|---|---|
| vector | tags Array(Tuple(String, String)), timestamp TimestampType, value ValueType | prometheusQuery(mytable, ‘up’) |
| matrix | tags Array(Tuple(String, String)), time_series Array(Tuple(TimestampType, ValueType)) | prometheusQuery(mytable, ‘up[1m]‘) |
| scalar | scalar ValueType | prometheusQuery(mytable, ‘1h30m’) |
| string | string String | prometheusQuery(mytable, ‘“abc”‘) |
支持的 PromQL 特性
选择器
=、!=、=~、!~) 、偏移修饰符、@ 时间戳修饰符，以及子查询。
函数
| 类别 | 函数 |
|---|---|
| 范围 | rate, irate, delta, idelta, last_over_time |
| 数学 | abs, sgn, floor, ceil, sqrt, exp, ln, log2, log10, rad, deg |
| 三角函数 | sin, cos, tan, asin, acos, atan, sinh, cosh, tanh, asinh, acosh, atanh |
| 日期时间 | day_of_week, day_of_month, days_in_month, day_of_year, minute, hour, month, year |
| 类型 | scalar, vector |
| 直方图 | histogram_quantile |
| 其他 | time, pi |
histogram_quantile 在经典直方图桶 (由 le 标签标识) 上使用线性插值。原生直方图暂不受支持，并且 phi (分位数级别) 参数目前必须是常量标量——像 histogram_quantile(time() / 1000, ...) 这样在每个 step 上都会变化的表达式，会因 NOT_IMPLEMENTED 错误而被拒绝。
运算符
+、-、*、/、%、^) 、比较 (==、!=、<、>、<=、>=，可选 bool) 和逻辑 (and、or、unless) 二元运算符，以及 on()/ignoring() 和 group_left()/group_right() 修饰符。
一元运算符 + 和 -。
聚合运算符
sum, avg, min, max, count, stddev, stdvar, group, quantile, topk, bottomk, limitk —— 可选搭配 by() 或 without() 修饰符。
暂不支持：count_values。