TDIGEST.BYRANK
Syntax
TDIGEST.BYRANK key rank [rank ...]
- Available in:
- Redis Stack / Bloom 2.4.0
- Time complexity:
- O(N) where N is the number of ranks specified.
对于每个输入排名,返回该排名的值(浮点数)的估计。
可以在一次调用中获取多个估计值。
必需的参数
key
is key name for an existing t-digest sketch.
rank
排名,应检索其值。
0 是最小观测值的秩。
n-1 是最大观测值的排名;n 表示添加到草图中的观测数量。
返回值
Array reply - 一个包含 value_1, value_2, ..., value_R 的浮点数数组:
- 当
rank
为0时返回准确结果(最小观测值) - 当
rank
为n-1(最大观测值)时,返回准确结果,其中n表示添加到草图中的观测数量。 - 当
rank
等于n或大于n时返回'inf'
如果草图为空,所有值都是'nan'。
示例
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.BYRANK t 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
1) "1"
2) "2"
3) "2"
4) "3"
5) "3"
6) "3"
7) "4"
8) "4"
9) "4"
10) "4"
11) "5"
12) "5"
13) "5"
14) "5"
15) "5"
16) "inf"