首页 > 技术文章 > Redis 有序集合(sorted set)

zhaoqiusheng 2020-03-27 09:29 原文

Redis 有序集合(sorted set)

Redis 有序集合和集合一样也是string类型元素的集合,且不允许重复的成员。

不同的是每个元素都会关联一个double类型的分数。redis正是通过分数来为集合中的成员进行从小到大的排序。

有序集合的成员是唯一的,但分数(score)却可以重复。

集合是通过哈希表实现的,所以添加,删除,查找的复杂度都是O(1)。 集合中最大的成员数为 232 - 1 (4294967295, 每个集合可存储40多亿个成员)。

1.Zadd命令

redis 127.0.0.1:6379> ZADD KEY_NAME SCORE1 VALUE1.. SCOREN VALUEN

Redis Zadd 命令用于将一个或多个成员元素及其分数值加入到有序集当中。

如果某个成员已经是有序集的成员,那么更新这个成员的分数值,并通过重新插入这个成员元素,来保证该成员在正确的位置上。

分数值可以是整数值或双精度浮点数。

如果有序集合 key 不存在,则创建一个空的有序集并执行 ZADD 操作。

当 key 存在但不是有序集类型时,返回一个错误。

注意: 在 Redis 2.4 版本以前, ZADD 每次只能添加一个元素。

返回 被成功添加的新成员的数量,不包括那些被更新的、已经存在的成员。

2.Zcard命令

redis 127.0.0.1:6379> ZCARD KEY_NAME

当 key 存在且是有序集类型时,返回有序集的基数。 当 key 不存在时,返回 0 。

3.Zcount命令

redis 127.0.0.1:6379> ZCOUNT key min max

返回分数值在 min 和 max 之间的成员的数量。

4.Zincrby命令

redis 127.0.0.1:6379> ZINCRBY key increment member

Redis Zincrby 命令对有序集合中指定成员的分数加上增量 increment

可以通过传递一个负数值 increment ,让分数减去相应的值,比如 ZINCRBY key -5 member ,就是让 member 的 score 值减去 5 。

当 key 不存在,或分数不是 key 的成员时, ZINCRBY key increment member 等同于 ZADD key increment member 。

当 key 不是有序集类型时,返回一个错误。

分数值可以是整数值或双精度浮点数。

返回member 成员的新分数值,以字符串形式表示。

5.Zinterstore命令

redis 127.0.0.1:6379> ZINTERSTORE destination numkeys key [key ...] [WEIGHTS weight [weight ...]] [AGGREGATE SUM|MIN|MAX]

Redis Zinterstore 命令计算给定的一个或多个有序集的交集,其中给定 key 的数量必须以 numkeys 参数指定,并将该交集(结果集)储存到 destination 。

默认情况下,结果集中某个成员的分数值是所有给定集下该成员分数值之和。

返回保存到目标结果集的的成员数量。

6.Zlexcount命令(版本>= 2.8.9)

redis 127.0.0.1:6379> ZLEXCOUNT KEY MIN MAX

Redis Zlexcount 命令在计算有序集合中指定字典区间内成员数量。

返回指定区间内的成员数量。

7.Zrange命令

redis 127.0.0.1:6379> ZRANGE key start stop [WITHSCORES]

Redis Zrange 返回有序集中,指定区间内的成员。

其中成员的位置按分数值递增(从小到大)来排序。

具有相同分数值的成员按字典序(lexicographical order )来排列。

如果你需要成员按

值递减(从大到小)来排列,请使用 ZREVRANGE 命令。

下标参数 start 和 stop 都以 0 为底,也就是说,以 0 表示有序集第一个成员,以 1 表示有序集第二个成员,以此类推。

你也可以使用负数下标,以 -1 表示最后一个成员, -2 表示倒数第二个成员,以此类推。

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

8.Zrangebylex命令(版本>= 2.8.9)(带lex就是按照字典取值)

redis 127.0.0.1:6379> ZRANGEBYLEX key min max [LIMIT offset count]

Redis Zrangebylex 通过字典区间返回有序集合的成员。

返回 指定区间内的元素列表。

9.Zrangebyscore命令(就是通过score区间取值)

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

Redis Zrangebyscore 返回有序集合中指定分数区间的成员列表。有序集成员按分数值递增(从小到大)次序排列。

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

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

举个例子:

ZRANGEBYSCORE zset (1 5

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

ZRANGEBYSCORE zset (5 (10

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

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

10.Zrank命令(就是按分数排序 返回排名的值)

redis 127.0.0.1:6379> ZRANK key member

Redis Zrank 返回有序集中指定成员的排名。其中有序集成员按分数值递增(从小到大)顺序排列。

如果成员是有序集 key 的成员,返回 member 的排名。 如果成员不是有序集 key 的成员,返回 nil 。

11.Zrem命令

redis 127.0.0.1:6379> ZREM key member [member ...]

Redis Zrem 命令用于移除有序集中的一个或多个成员,不存在的成员将被忽略。

当 key 存在但不是有序集类型时,返回一个错误。

注意: 在 Redis 2.4 版本以前, ZREM 每次只能删除一个元素。

返回被成功移除的成员的数量,不包括被忽略的成员。

12.Zremrangebylex命令(版本>= 2.8.9)

redis 127.0.0.1:6379> ZREMRANGEBYLEX key min max

Redis Zremrangebylex 命令用于移除有序集合中给定的字典区间的所有成员。

返回被成功移除的成员的数量,不包括被忽略的成员。

13.Zremrangebyrank命令(下标 下标 下标 重要事情说三遍)

redis 127.0.0.1:6379> ZREMRANGEBYRANK key start stop

Redis Zremrangebyrank 命令用于移除有序集中,指定排名(rank)区间内的所有成员

14.Zremrangebyscore命令

redis 127.0.0.1:6379> ZREMRANGEBYSCORE key min max

Redis Zremrangebyscore 命令用于移除有序集中,指定分数(score)区间内的所有成员。

返回被移除成员的数量。

15.Zrevrange命令(按分数从大到小排序)

redis 127.0.0.1:6379> ZREVRANGE key start stop [WITHSCORES]

Redis Zrevrange 命令返回有序集中,指定区间内的成员。

其中成员的位置按分数值递减(从大到小)来排列。

具有相同分数值的成员按字典序的逆序(reverse lexicographical order)排列。

除了成员按分数值递减的次序排列这一点外, ZREVRANGE 命令的其他方面和 ZRANGE 命令一样。

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

16.Zscore命令(通过成员名字 查询score)

redis 127.0.0.1:6379> ZSCORE key member

Redis Zscore 命令返回有序集中,成员的分数值。 如果成员元素不是有序集 key 的成员,或 key 不存在,返回 nil 。

成员的分数值,以字符串形式表示。

17.Zunionstore命令(乘以 WEIGHTS后的并集

redis 127.0.0.1:6379> ZUNIONSTORE destination numkeys key [key ...] [WEIGHTS weight [weight ...]] [AGGREGATE SUM|MIN|MAX]

Redis Zunionstore 命令计算给定的一个或多个有序集的并集,其中给定 key 的数量必须以 numkeys 参数指定,并将该并集(结果集)储存到 destination 。

默认情况下,结果集中某个成员的分数值是所有给定集下该成员分数值之和 。

返回 保存到 destination 的结果集的成员数量。

18 zscan命令

 

 

 

 

推荐阅读