TDIGEST.QUANTILE
Syntax
TDIGEST.QUANTILE key quantile [quantile ...]
Available in:
Redis Open Source / Bloom 2.4.0
Time complexity:
O(N) where N is the number of quantiles specified.
ACL categories:
@tdigest,
@read,
Compatibility:
Redis Enterprise and Redis Cloud compatibility
Returns, for each input fraction, a floating-point estimation of the value that is smaller than the given fraction of observations.
Multiple quantiles can be retrieved in a single call.
Required arguments
keyis the key name for an existing t-digest sketch.
quantileis the input fraction between 0 and 1 inclusively.
Examples
redis> TDIGEST.CREATE t COMPRESSION 1000
OK
redis> TDIGEST.ADD t 1 2 2 3 3 3 4 4 4 4 5 5 5 5 5
OK
redis> TDIGEST.QUANTILE t 0 0.1 0.2 0.3 0.4 0.5 0.6 0.7 0.8 0.9 1
1) "1"
2) "2"
3) "3"
4) "3"
5) "4"
6) "4"
7) "4"
8) "5"
9) "5"
10) "5"
11) "5"
Redis Enterprise and Redis Cloud compatibility
Redis
Redis
Notes
✅ Supported ✅ Flexible & Annual ✅ Free & Fixed
RESP2
RESP3
One of the following:
Array of bulk string replies as floating-point estimates, populated with value_1, value_2, ..., value_N.
an accurate result when quantile is 0, the value of the smallest observation.
an accurate result when quantile is 1, the value of the largest observation.
nan for all quantiles when the given sketch is empty.
Simple error reply in these cases: the given key does not exist or is of an incorrect type, quantile parsing errors, or incorrect number of arguments.
One of the following:
Array of double replies as estimates, populated with value_1, value_2, ..., value_N.
an accurate result when quantile is 0, the value of the smallest observation.
an accurate result when quantile is 1, the value of the largest observation.
nan for all quantiles when the given sketch is empty.
Simple error reply in these cases: the given key does not exist or is of an incorrect type, quantile parsing errors, or incorrect number of arguments.