Redis ZRANGEBYSCORE 命令 - Redis 基础教程

Redis ZRANGEBYSCORE 命令返回有序集 key 中，所有 score 值介于 min 和 max 之间(包括等于 min 或 max )的成员

( Redis >= 1.0.5 )

Redis 有序集成员按 score 值递增(从小到大)次序排列。

具有相同 score 值的成员按字典序(lexicographical order)来排列(该属性是有序集提供的，不需要额外的计算)。

语法

Redis ZRANGEBYSCORE 命令语法如下：

127.0.0.1:6379> ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT offset count]

可选的 LIMIT 参数指定返回结果的数量及区间(就像SQL中的 SELECT LIMIT offset, count )，注意当 offset 很大时，定位 offset 的操作可能需要遍历整个有序集，此过程最坏复杂度为 O(N) 时间。
可选的 WITHSCORES 参数决定结果集是单单返回有序集的成员，还是将有序集成员及其 score 值一起返回。该选项自 Redis 2.0 版本起可用。

min 和 max 可以是 -inf 和 +inf ，这样一来，你就可以在不知道有序集的最低和最高 score 值的情况下，使用 ZRANGEBYSCORE 这类命令。

默认情况下，区间的取值使用闭区间 (小于等于或大于等于)，也可以通过给参数前增加 ( 符号来使用可选的开区间 (小于或大于)。

举个例子：

ZRANGEBYSCORE zset (1 5

返回所有符合条件 1 < score <= 5 的成员，而

ZRANGEBYSCORE zset (5 (10

则返回所有符合条件 5 < score < 10 的成员。

返回值

指定区间内，带有分数值(可选)的有序集成员的列表。

范例

127.0.0.1:6379> FLUSHALL
OK
127.0.0.1:6379> ZADD chars 1 a 2 b 2 c 3 d 3 e 4 f 4 g 5 h 5 i
(integer) 9

127.0.0.1:6379> ZRANGEBYSCORE chars -inf +inf      # 显示整个有序集
1) "a"
2) "b"
3) "c"
4) "d"
5) "e"
6) "f"
7) "g"
8) "h"
9) "i"

127.0.0.1:6379> ZRANGEBYSCORE chars -inf +inf WITHSCORES  # 显示整个有序集及成员的 score 值
 1) "a"
 2) "1"
 3) "b"
 4) "2"
 5) "c"
 6) "2"
 7) "d"
 8) "3"
 9) "e"
10) "3"
11) "f"
12) "4"
13) "g"
14) "4"
15) "h"
16) "5"
17) "i"
18) "5"

127.0.0.1:6379> ZRANGEBYSCORE chars -inf 4 WITHSCORES    # 显示 score <=5000 的所有成员
 1) "a"
 2) "1"
 3) "b"
 4) "2"
 5) "c"
 6) "2"
 7) "d"
 8) "3"
 9) "e"
10) "3"
11) "f"
12) "4"
13) "g"
14) "4"

127.0.0.1:6379> ZRANGEBYSCORE salary (2 4          # 显示 score 大于 2 小于等于 4 的成员
1) "d"
2) "3"
3) "e"
4) "3"
5) "f"
6) "4"
7) "g"
8) "4"