目录
一、概念
有序集合相对于字符串、列表、哈希、集合来说会有⼀些陌生。它保留了集合不能有重复成员的
特点，但与集合不同的是，有序集合中的每个元素都有⼀个唯⼀的浮点类型的分数（score）与之关联，着使得有序集合中的元素是可以维护有序性的，但这个有序不是用下标作为排序依据而是用这个分数。
有序集合提供了获取指定分数和元素范围查找、计算成员排名等功能，合理地利用有序集合，可以帮助我们在实际开发中解决很多问题。
有序集合中的元素是不能重复的，但分数允许重复。类比于⼀次考试之后，每个人⼀定有⼀
个唯⼀的分数，但分数允许相同。
二、普通命令
2.1 ZADD
添加或者更新指定的元素以及关联的分数到 zset 中，分数应该符合 double 类型，+inf/-inf 作为正负极限也是合法的。
语法：
ZADD key [NX | XX] [GT | LT] [CH] [INCR] score member [score member...]
命令有效版本：1.2.0 之后
时间复杂度：O(log(N))
返回值：本次添加成功的元素个数。
示例：
redis> ZADD myzset 1 "one"
(integer) 1
redis> ZADD myzset 1 "uno"
(integer) 1
redis> ZADD myzset 2 "two" 3 "three"
(integer) 2
redis> ZRANGE myzset 0 -1 WITHSCORES
1) "one"
2) "1"
3) "uno"
4) "1"
5) "two"
6) "2"
7) "three"
8) "3"
redis> ZADD myzset 10 one 20 two 30 three
(integer) 0
redis> ZRANGE myzset 0 -1 WITHSCORES
1) "uno"
2) "1"
3) "one"
4) "10"
5) "two"
6) "20"
7) "three"
8) "30"
redis> ZADD myzset CH 100 one 200 two 300 three
(integer) 3
redis> ZRANGE myzset 0 -1 WITHSCORES
1) "uno"
2) "1"
3) "one"
4) "100"
5) "two"
6) "200"
7) "three"
8) "300"
redis> ZADD myzset XX 1 one 2 two 3 three 4 four 5 five
(integer) 0
redis> ZRANGE myzset 0 -1 WITHSCORES
1) "one"
2) "1"
3) "uno"
4) "1"
5) "two"
6) "2"
7) "three"
8) "3"
redis> ZADD myzset NX 100 one 200 two 300 three 400 four 500 five
(integer) 2
redis> ZRANGE myzset 0 -1 WITHSCORES
1) "one"
2) "1"
3) "uno"
4) "1"
5) "two"
6) "2"
7) "three"
8) "3"
9) "four"
10) "400"
11) "five"
12) "500"
redis> ZADD myzset INCR 10 one
"11"
redis> ZRANGE myzset 0 -1 WITHSCORES
1) "uno
2) "1"
3) "two"
4) "2"
5) "three"
6) "3"
7) "one"
8) "11"
9) "four"
10) "400"
11) "five"
12) "500"
redis> ZADD myzset -inf "negative infinity" +inf "positive infinity"
(integer) 2
redis> ZRANGE myzset 0 -1 WITHSCORES
1) "negative infinity"
2) "-inf"
3) "uno"
4) "1"
5) "two"
6) "2"
7) "three"
8) "3"
9) "one"
10) "11"
11) "four"
12) "400"
13) "five"
14) "500"
15) "positive infinity"
16) "inf“2.2 ZCARD
获取⼀个 zset 的基数（cardinality），即 zset 中的元素个数。
语法：
ZCARD key
命令有效版本：1.2.0 之后
时间复杂度：O(1)
返回值：zset 内的元素个数。
示例：
redis> ZADD myzset 1 "one"
(integer) 1
redis> ZADD myzset 2 "two"
(integer) 1
redis> ZCARD myzset
(integer) 22.3 ZCOUNT
返回分数在 min 和 max 之间的元素个数，默认情况下，min 和 max 都是包含的。
语法：
ZCOUNT key min max
命令有效版本：2.0.0 之后
时间复杂度：O(log(N))
返回值：满足条件的元素列表个数。
示例：
redis> ZADD myzset 1 "one"
(integer) 1
redis> ZADD myzset 2 "two"
(integer) 1
redis> ZADD myzset 3 "three"
(integer) 1
redis> ZCOUNT myzset -inf +inf
(integer) 3
redis> ZCOUNT myzset 1 3
(integer) 3
redis> ZCOUNT myzset (1 3
(integer) 2
redis> ZCOUNT myzset (1 (3
(integer) 12.4 ZRANGE
返回指定区间里的元素，分数按照升序。带上 WITHSCORES 可以把分数也返回。
语法：
ZRANGE key start stop [WITHSCORES]
命令有效版本：1.2.0 之后
时间复杂度：O(log(N)+M)
返回值：区间内的元素列表。
示例：
redis> ZADD myzset 1 "one"
(integer) 1
redis> ZADD myzset 2 "two"
(integer) 1
redis> ZADD myzset 3 "three"
(integer) 1
redis> ZRANGE myzset 0 -1 WITHSCORES
1) "one"
2) "1"
3) "two"
4) "2"
5) "three"
6) "3"
redis> ZRANGE myzset 0 -1
1) "one"
2) "two"
3) "three"
redis> ZRANGE myzset 2 3
1) "three"
redis> ZRANGE myzset -2 -1
1) "two"
2) "three"2.5 ZREVRANGE
返回指定区间里的元素，分数按照降序。带上 WITHSCORES 可以把分数也返回。
备注：这个命令可能在 6.2.0 之后废弃，并且功能合并到 ZRANGE 中。
语法：
ZREVRANGE key start stop [WITHSCORES]
命令有效版本：1.2.0 之后
时间复杂度：O(log(N)+M)
返回值：区间内的元素列表。
示例：
redis> ZADD myzset 1 "one"
(integer) 1
redis> ZADD myzset 2 "two"
(integer) 1
redis> ZADD myzset 3 "three"
(integer) 1
redis> ZREVRANGE myzset 0 -1 WITHSCORES
1) "three"
2) "3"
3) "two"
4) "2"
5) "one"
6) "1"
redis> ZREVRANGE myzset 0 -1
1) "three"
2) "two"
3) "one"
redis> ZREVRANGE myzset 2 3
1) "one"
redis> ZREVRANGE myzset -2 -1
1) "two"
2) "one"2.6 ZRANGEBYSCORE
返回分数在 min 和 max 之间的元素，默认情况下，min 和 max 都是包含的。
备注：这个命令可能在 6.2.0 之后废弃，并且功能合并到 ZRANGE 中。
语法：
ZRANGEBYSCORE key min max [WITHSCORES]
命令有效版本：1.0.5 之后
时间复杂度：O(log(N)+M)
返回值：区间内的元素列表。
示例：
redis> ZADD myzset 1 "one"
(integer) 1
redis> ZADD myzset 2 "two"
(integer) 1
redis> ZADD myzset 3 "three"
(integer) 1
redis> ZRANGEBYSCORE myzset -inf +inf
1) "one"
2) "two"
3) "three"
redis> ZRANGEBYSCORE myzset 1 2
1) "one"
2) "two"
redis> ZRANGEBYSCORE myzset (1 2
1) "two"
redis> ZRANGEBYSCORE myzset (1 (2
(empty array)2.7 ZPOPMAX
删除并返回分数最高的 count 个元素。
语法：
ZPOPMAX key [count]
命令有效版本：5.0.0 之后
时间复杂度：O(log(N) * M)
返回值：分数和元素列表。
示例：
redis> ZADD myzset 1 "one"
(integer) 1
redis> ZADD myzset 2 "two"
(integer) 1
redis> ZADD myzset 3 "three"
(integer) 1
redis> ZPOPMAX myzset
1) "three"
2) "3"2.8 BZPOPMAX
ZPOPMAX 的阻塞版本。
语法：
BZPOPMAX key [key ...] timeout2.9 ZPOPMIN
删除并返回分数最低的 count 个元素。
2.10 BZPOPMIN
ZPOPMIN的阻塞版本。
2.11 ZRANK
返回指定元素的排名，升序。
语法：
ZRANK key member
命令有效版本：2.0.0 之后
时间复杂度：O(log(N))
返回值：排名。
示例：
redis> ZADD myzset 1 "one"
(integer) 1
redis> ZADD myzset 2 "two"
(integer) 1
redis> ZADD myzset 3 "three"
(integer) 1
redis> ZRANK myzset "three"
(integer) 2
redis> ZRANK myzset "four"
(nil)2.12 ZREVRANK
返回指定元素的排名，降序。
2.13 ZSCORE
返回指定元素的分数。
语法：
ZSCORE key member
命令有效版本：1.2.0 之后
时间复杂度：O(1)
返回值：分数。
redis> ZADD myzset 1 "one"
(integer) 1
redis> ZSCORE myzset "one"
"1"2.14 ZREM
删除指定元素。
语法：
ZREM key member [member...]
命令有效版本：1.2.0 之后
时间复杂度：O(M*log(N))
返回值：本次操作删除的元素个数。
示例：
redis> ZADD myzset 1 "one"
(integer) 1
redis> ZADD myzset 2 "two"
(integer) 1
redis> ZADD myzset 3 "three"
(integer) 1
redis> ZREM myzset "two"
(integer) 1
redis> ZRANGE myzset 0 -1 WITHSCORES
1) "one"
2) "1"
3) "three"
4) "3"2.15 ZREMRANGEBYRANK
按照排序，升序删除指定范围的元素，左闭右闭。
语法：
ZREMRANGEBYRANK key start stop
命令有效版本：2.0.0 之后
时间复杂度：O(log(N)+M)
返回值：本次操作删除的元素个数。
示例：
redis> ZADD myzset 1 "one"
(integer) 1
redis> ZADD myzset 2 "two"
(integer) 1
redis> ZADD myzset 3 "three"
(integer) 1
redis> ZREMRANGEBYRANK myzset 0 1
(integer) 2
redis> ZRANGE myzset 0 -1 WITHSCORES
1) "three"
2) "3"2.16 ZREMRANGEBYSCORE
按照分数删除指定范围的元素，左闭右闭。
语法：
ZREMRANGEBYSCORE key min max
命令有效版本：1.2.0 之后
时间复杂度：O(log(N)+M)
返回值：本次操作删除的元素个数。
示例：
redis> ZADD myzset 1 "one"
(integer) 1
redis> ZADD myzset 2 "two"
(integer) 1
redis> ZADD myzset 3 "three"
(integer) 1
redis> ZREMRANGEBYSCORE myzset -inf (2
(integer) 1
redis> ZRANGE myzset 0 -1 WITHSCORES
1) "two"
2) "2"
3) "three"
4) "3"2.17 ZINCRBY
为指定的元素的关联分数添加指定的分数值。
语法：
ZINCRBY key increment member
命令有效版本：1.2.0 之后
时间复杂度：O(log(N))
返回值：增加后元素的分数。
示例：
redis> ZADD myzset 1 "one"
(integer) 1
redis> ZADD myzset 2 "two"
(integer) 1
redis> ZINCRBY myzset 2 "one"
"3"
redis> ZRANGE myzset 0 -1 WITHSCORES
1) "two"
2) "2"
3) "one"
4) "3"三、集合间操作
3.1 ZINTERSTORE
求出给定有序集合中元素的交集并保存进目标有序集合中，在合并过程中以元素为单位进行合并，元素对应的分数按照不同的聚合方式和权重得到新的分数。
语法：
ZINTERSTORE destination numkeys key [key ...]
[WEIGHTS weight [weight ...]] [AGGREGATE <SUM | MIN | MAX>]
命令有效版本：2.0.0 之后
时间复杂度：O(N*K)+O(M*log(M)) N 是输⼊的有序集合中, 最小的有序集合的元素个数; K 是输入了几个有序集合; M 是最终结果的有序集合的元素个数.
返回值：目标集合中的元素个数
示例：
redis> ZADD zset1 1 "one"
(integer) 1
redis> ZADD zset1 2 "two"
(integer) 1
redis> ZADD zset2 1 "one"
(integer) 1
redis> ZADD zset2 2 "two"
(integer) 1
redis> ZADD zset2 3 "three"
(integer) 1
redis> ZINTERSTORE out 2 zset1 zset2 WEIGHTS 2 3
(integer) 2
redis> ZRANGE out 0 -1 WITHSCORES
1) "one"
2) "5"
3) "two"
4) "10"3.2 ZUNIONSTORE
求出给定有序集合中元素的并集并保存进⽬标有序集合中，在合并过程中以元素为单位进行合并，元素对应的分数按照不同的聚合方式和权重得到新的分数。
语法：
ZUNIONSTORE destination numkeys key [key ...] [WEIGHTS weight
[weight ...]] [AGGREGATE <SUM | MIN | MAX>]
命令有效版本：2.0.0 之后
时间复杂度：O(N)+O(M*log(M)) N 是输⼊的有序集合总的元素个数; M 是最终结果的有序集合的元素个数.
返回值：目标集合中的元素个数
示例：
redis> ZADD zset1 1 "one"
(integer) 1
redis> ZADD zset1 2 "two"
(integer) 1
redis> ZADD zset2 1 "one"
(integer) 1
redis> ZADD zset2 2 "two"
(integer) 1
redis> ZADD zset2 3 "three"
(integer) 1
redis> ZUNIONSTORE out 2 zset1 zset2 WEIGHTS 2 3
(integer) 3
redis> ZRANGE out 0 -1 WITHSCORES
1) "one"
2) "5"
3) "three"
4) "9"
5) "two"
6) "10"四、内部编码
有序集合的内部编码有两种：
ziplist(压缩集合)：当有序集合的元素个数小于 zset-max-ziplist-entries 配置（默认 128 个）， 同时每个元素的值都小于 zset-max-ziplist-value 配置（默认 64 字节）时，Redis 会用 ziplist 来作为有序集合的内部实现，ziplist 可以有效减少内存的使用。
skiplist(跳表)：当 ziplist 条件不满足时，有序集合会使用 skiplist 作为内部实现，因为此时ziplist 的操作效率会下降。
扫一扫
338
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
