TDIGEST.BYRANK
语法
TDIGEST.BYRANK key rank [rank ...]
- 可用版本
- Redis 开源版 / Bloom 2.4.0
- 时间复杂度
- O(N),其中 N 是指定的排名数量。
- ACL 类别
-
@tdigest,@read,
对于每个输入的排名,返回该排名对应值的估计值(浮点数)。
单次调用中可以检索多个估计值。
必需参数
key
是现有 t-digest sketch 的键名。rank
排名,应检索该排名对应的值。
0 是最小观测值的排名。
n-1 是最大观测值的排名;n 表示添加到 sketch 的观测值数量。
返回值
数组回复 - 包含 value_1, value_2, ..., value_R 的浮点数组
- 当
rank为 0 时返回精确结果(最小观测值) - 当
rank为 n-1 时返回精确结果(最大观测值),其中 n 表示添加到 sketch 的观测值数量。 - 当
rank等于 n 或大于 n 时返回 'inf'
如果 sketch 为空,所有值都为 '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"