メインコンテンツへスキップ
一定の評価時刻範囲にわたって、TimeSeriesテーブルのデータを使用してPrometheusクエリを評価します。

構文

引数

  • db_name - TimeSeries テーブルが存在するデータベースの名前。
  • time_series_table - TimeSeries テーブルの名前。
  • promql_query - PromQL 構文で記述されたクエリ。
  • start_time - 評価範囲の開始時刻。
  • end_time - 評価範囲の終了時刻。
  • step - 評価時刻を start_time から end_time まで (両端を含む) 順に進める際のステップ。

戻り値

この関数は、パラメータ promql_query に渡されたクエリの結果タイプに応じて、返されるカラムが異なります。

PromQL でサポートされている機能

セレクタ

インスタントセレクタ、範囲セレクタ、ラベルマッチャー (=, !=, =~, !~) 、offset 修飾子、@ タイムスタンプ修飾子、サブクエリ。

関数

: histogram_quantile は、従来のヒストグラムバケット (le ラベルで識別) に対して線形補間を使用します。ネイティブヒストグラムはまだサポートされておらず、phi (quantile level) 引数は現時点では定数スカラーである必要があります。histogram_quantile(time() / 1000, ...) のようにステップごとに変化する式は受け付けられず、NOT_IMPLEMENTED エラーになります。

演算子

on()/ignoring() および group_left()/group_right() 修飾子付きの、すべての算術 (+, -, *, /, %, ^) 、比較 (オプションの bool を付けた ==, !=, <, >, <=, >=) 、および論理 (and, or, unless) 二項演算子。 単項演算子 +-

集計演算子

sum, avg, min, max, count, stddev, stdvar, group, quantile, topk, bottomk, limitk — オプションで by() または without() 修飾子を指定できます。 現時点では count_values はサポートされていません。

最終更新日 2026年7月2日