quantileTiming

指定された精度で、数値データ系列の 分位数 (quantile) を計算します。

結果は決定論的であり（クエリの処理順序には依存しません）、Web ページの読み込み時間やバックエンドのレスポンス時間などの分布を表す系列を処理するよう最適化されています。

1 つのクエリ内で異なるレベルの複数の quantile* 関数を使用する場合、内部状態は結合されません（つまり、そのクエリは本来可能なほど効率的には動作しません）。このような場合は、quantiles 関数を使用してください。

構文

quantileTiming(level)(expr)

Alias: medianTiming.

引数

• level — 分位数のレベル。省略可能なパラメータ。0 から 1 の間の定数の浮動小数点数。level の値は [0.01, 0.99] の範囲で使用することを推奨します。デフォルト値: 0.5。level=0.5 の場合、この関数は中央値を計算します。

• expr — カラム値に対する式で、Float* 型の数値を返します。

  • 負の値が関数に渡された場合、その動作は未定義です。
  • 値が 30,000（ページ読み込み時間が 30 秒を超える場合）より大きい場合、その値は 30,000 として扱われます。

精度

次の場合、計算結果は正確です。

• 値の総数が 5670 を超えない場合。
• 値の総数が 5670 を超えるが、ページ読み込み時間が 1024 ms 未満の場合。

それ以外の場合、計算結果は 16 ms の倍数に丸められます。

注記

ページ読み込み時間の分位数を計算する場合、この関数は quantile よりも効率的で高精度です。

戻り値

• 指定したレベルの分位数。

型: Float32。

注記

関数に値が 1 つも渡されない場合（quantileTimingIf を使用しているとき）、NaN が返されます。これは、このようなケースを結果がゼロになるケースと区別するためです。NaN 値のソートに関する注意事項については、ORDER BY 句 を参照してください。

例

入力テーブル:

┌─response_time─┐
│            72 │
│           112 │
│           126 │
│           145 │
│           104 │
│           242 │
│           313 │
│           168 │
│           108 │
└───────────────┘

クエリ:

SELECT quantileTiming(response_time) FROM t

結果：

┌─quantileTiming(response_time)─┐
│                           126 │
└───────────────────────────────┘

関連項目

• median
• quantiles