Skip to content

approx_percentile_rank()

Estimate the percentile of a given value from a `tdigest`

Since 1.0.0

Estimate the percentile at which a given value would be located.

Estimate the percentile rank of the value 99, given a sample containing the numbers from 0 to 100.

SELECT
approx_percentile_rank(99, tdigest(data))
FROM generate_series(0, 100) data;
approx_percentile_rank
----------------------------
0.9851485148514851

The syntax is:

approx_percentile_rank(
value DOUBLE PRECISION,
digest TDigest
) RETURNS DOUBLE PRECISION
NameTypeDefaultRequiredDescription
valueDOUBLE PRECISION-The value to estimate the percentile of
digestTDigest-The tdigest aggregate
ColumnTypeDescription
approx_percentile_rankDOUBLE PRECISIONThe estimated percentile associated with the provided value.