documentationtdigest_quantile¶
Description¶
Calculates a quantile from a TDigest state.
Return type¶
float64
Domain¶
This is a scalar function (calculates a single output value for a single input row.)
Categories¶
Usage¶
tdigest_quantile(inputExpr, quantile)
Argument |
Type |
Optional |
Repeatable |
Restrictions |
|---|---|---|---|---|
inputExpr |
tdigest |
no |
no |
none |
quantile |
float64 |
no |
no |
constant |
Examples¶
make_col quantile:tdigest_quantile(tdigest_col, .95)
Calculate the 95nd percentile of the data summarized in tdigest_col.
timechart 5m, durations_tdigest:tdigest(duration_col), group_by(^Cluster)
statsby quantile:tdigest_quantile(durations_tdigest, .98)
This is the typical use case: use t-digest to pre-aggregate numeric values with a decomposable aggregate function, and ultimately calculating a quantile value from it.
First, aggregate the durations both in time buckets of the desired width and by Cluster.
Then, calculate the 98th percentile.