语法
参数
db_name- TimeSeries 表所在的数据库名称。time_series_table- TimeSeries 表的名称。promql_query- 使用 PromQL 语法 编写的查询。evaluation_time - 求值时间戳。要在当前时间对查询进行求值，请使用now()作为evaluation_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, ...) 这样每个时间步都会变化的表达式会因 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。