文章目录:
1.开篇
Redis有序集合和集合一样也是 string 类型元素的集合,且不允许重复的成员。
不同的是每个元素都会关联一个 double 类型的分数。redis 正是通过分数来为集合中的成员进行从小到大的排序。
有序集合的成员是唯一的,但分数(score)却可以重复。
集合是通过哈希表实现的,所以添加,删除,查找的复杂度都是 O(1)。集合中最大的成员数为 232 - 1 (4294967295, 每个集合可存储40多亿个成员)。
2.Redis有序集合(ZSet)的相关命令
序号 |
命令及描述 |
1 |
ZADD key score1 member1 [score2 member2] |
2 |
ZCARD key |
3 |
ZCOUNT key min max |
4 |
ZINCRBY key increment member |
5 |
ZINTERSTORE destination numkeys key [key...] |
6 |
ZLEXCOUNT key min max |
7 |
ZRANGE key start stop [WITHSCORES] |
8 |
ZRANGEBYLEX key min max [LIMIT offset count] |
9 |
ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT] |
10 |
ZRANK key member |
11 |
ZREM key member [member...] |
12 |
ZREMRANGEBYLEX key min max |
13 |
ZREMRANGEBYRANK key start stop |
14 |
ZREMRANGEBYSCORE key min max |
15 |
ZREVRANGE key start stop [WITHSCORES] |
16 |
ZREVRANGEBYSCORE key max min [WITHSCORES] |
17 |
ZREVRANK key member |
18 |
ZSCORE key member |
19 |
ZUNIONSTORE destination numkeys key [key...] |
20 |
ZSCAN key cursor [MATCH pattern] [COUNT count] |
2.1 ZADD命令
Redis Zadd 命令用于将一个或多个成员元素及其分数值加入到有序集当中。
如果某个成员已经是有序集的成员,那么更新这个成员的分数值,并通过重新插入这个成员元素,来保证该成员在正确的位置上。
分数值可以是整数值或双精度浮点数。
如果有序集合 key 不存在,则创建一个空的有序集并执行 ZADD 操作。
当 key 存在但不是有序集类型时,返回一个错误。
注意: 在 Redis 2.4 版本以前, ZADD 每次只能添加一个元素。
redis 127.0.0.1:6379> ZADD KEY_NAME SCORE1 VALUE1.. SCOREN VALUEN
被成功添加的新成员的数量,不包括那些被更新的、已经存在的成员。
2.2 ZRANGE命令
Redis Zrange 返回有序集中,指定区间内的成员。
其中成员的位置按分数值递增(从小到大)来排序。
具有相同分数值的成员按字典序(lexicographical order )来排列。
下标参数 start 和 stop 都以 0 为底,也就是说,以 0 表示有序集第一个成员,以 1 表示有序集第二个成员,以此类推。
你也可以使用负数下标,以 -1 表示最后一个成员, -2 表示倒数第二个成员,以此类推。
redis 127.0.0.1:6379> ZRANGE key start stop [WITHSCORES]
指定区间内,带有分数值(可选)的有序集成员的列表。
Redis Zrevrange 命令返回有序集中,指定区间内的成员。
其中成员的位置按分数值递减(从大到小)来排列。
具有相同分数值的成员按字典序的逆序(reverse lexicographical order)排列。
redis 127.0.0.1:6379> ZREVRANGE key start stop [WITHSCORES]
指定区间内,带有分数值(可选)的有序集成员的列表。
2.4 ZRANGEBYLEX命令
Redis Zrangebylex 通过字典区间返回有序集合的成员。
redis 127.0.0.1:6379> ZRANGEBYLEX key min max [LIMIT offset count]
指定区间内的元素列表。
2.5 ZRANGEBYSCORE命令
Redis Zrangebyscore 返回有序集合中指定分数区间的成员列表。有序集成员按分数值递增(从小到大)次序排列。
具有相同分数值的成员按字典序来排列(该属性是有序集提供的,不需要额外的计算)。
默认情况下,区间的取值使用闭区间 (小于等于或大于等于),你也可以通过给参数前增加 ( 符号来使用可选的开区间 (小于或大于)。
举个例子:
ZRANGEBYSCORE zset (1 5
返回所有符合条件 1 < score <= 5 的成员,而
ZRANGEBYSCORE zset (5 (10
则返回所有符合条件 5 < score < 10 的成员。
redis 127.0.0.1:6379> ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT offset count]
指定区间内,带有分数值(可选)的有序集成员的列表。
Redis Zrevrangebyscore 返回有序集中指定分数区间内的所有的成员。有序集成员按分数值递减(从大到小)的次序排列。
具有相同分数值的成员按字典序的逆序(reverse lexicographical order )排列。
redis 127.0.0.1:6379> ZREVRANGEBYSCORE key max min [WITHSCORES] [LIMIT offset count]
指定区间内,带有分数值(可选)的有序集成员的列表。
Redis Zcard 命令用于计算集合中元素的数量。
redis 127.0.0.1:6379> ZCARD KEY_NAME
当 key 存在且是有序集类型时,返回有序集的基数。当 key 不存在时,返回 0 。
Redis Zcount 命令用于计算有序集合中指定分数区间的成员数量。
redis 127.0.0.1:6379> ZCOUNT key min max
分数值在 min 和 max 之间的成员的数量。
Redis Zlexcount 命令在计算有序集合中指定字典区间内成员数量。
redis 127.0.0.1:6379> ZLEXCOUNT KEY MIN MAX
指定区间内的成员数量。
Redis Zscore 命令返回有序集中,成员的分数值。如果成员元素不是有序集 key 的成员,或 key 不存在,返回 nil 。
redis 127.0.0.1:6379> ZSCORE key member
成员的分数值,以字符串形式表示。
Redis Zincrby 命令对有序集合中指定成员的分数加上增量 increment
可以通过传递一个负数值 increment ,让分数减去相应的值,比如 ZINCRBY key -5 member ,就是让 member 的 score 值减去 5 。
当 key 不存在,或分数不是 key 的成员时, ZINCRBY key increment member 等同于 ZADD key increment member。
当 key 不是有序集类型时,返回一个错误。
分数值可以是整数值或双精度浮点数。
redis 127.0.0.1:6379> ZINCRBY key increment member
member成员的新分数值,以字符串形式表示。
Redis Zrank 返回有序集中指定成员的排名。其中有序集成员按分数值递增(从小到大)顺序排列。
redis 127.0.0.1:6379> ZRANK key member
如果成员是有序集 key 的成员,返回 member 的排名。如果成员不是有序集 key 的成员,返回 nil 。
2.13 ZREVRANK命令
Redis Zrevrank 命令返回有序集中成员的排名。其中有序集成员按分数值递减(从大到小)排序。
排名以 0 为底,也就是说,分数值最大的成员排名为 0 。
使用 ZRANK 命令可以获得成员按分数值递增(从小到大)排列的排名。
redis 127.0.0.1:6379> ZREVRANK key member
如果成员是有序集 key 的成员,返回成员的排名。如果成员不是有序集 key 的成员,返回 nil 。
Redis Zrem 命令用于移除有序集中的一个或多个成员,不存在的成员将被忽略。
当 key 存在但不是有序集类型时,返回一个错误。
redis 127.0.0.1:6379> ZREM key member [member ...]
被成功移除的成员的数量,不包括被忽略的成员。
Redis Zremrangebylex 命令用于移除有序集合中给定的字典区间的所有成员。
redis 127.0.0.1:6379> ZREMRANGEBYLEX key min max
被成功移除的成员的数量,不包括被忽略的成员。
Redis Zremrangebyrank 命令用于移除有序集中,指定排名(rank)区间内的所有成员。
redis 127.0.0.1:6379> ZREMRANGEBYRANK key start stop
被移除成员的数量。
Redis Zremrangebyscore 命令用于移除有序集中,指定分数(score)区间内的所有成员。
redis 127.0.0.1:6379> ZREMRANGEBYSCORE key min max
被移除成员的数量。
Redis Zunionstore 命令计算给定的一个或多个有序集的并集,其中给定 key 的数量必须以 numkeys 参数指定,并将该并集(结果集)储存到 destination 。
默认情况下,结果集中某个成员的分数值是所有给定集下该成员分数值之和。
WEIGHTS选项,与前面设定的可以对应,对应key中每一个score都要乘以这个权重
AGGREGATE选项,指定并集结果的聚合方式
SUM:将所有集合中某一个元素的score值之和作为结果集中该成员的score值
MIN:将所有集合中某一个元素的score值中最小值作为结果集中该成员的score值
MAX:将所有集合中某一个元素score值中最大值作为结果集中该成员的score值
redis 127.0.0.1:6379> ZUNIONSTORE destination numkeys key [key ...] [WEIGHTS weight [weight ...]] [AGGREGATE SUM|MIN|MAX]
保存到 destination 的结果集的成员数量。
Redis Zinterstore 命令计算给定的一个或多个有序集的交集,其中给定 key 的数量必须以 numkeys 参数指定,并将该交集(结果集)储存到 destination 。
默认情况下,结果集中某个成员的分数值是所有给定集下该成员分数值之和。
WEIGHTS选项,与前面设定的可以对应,对应key中每一个score都要乘以这个权重
AGGREGATE选项,指定并集结果的聚合方式
SUM:将所有集合中某一个元素的score值之和作为结果集中该成员的score值
MIN:将所有集合中某一个元素的score值中最小值作为结果集中该成员的score值
MAX:将所有集合中某一个元素score值中最大值作为结果集中该成员的score值
redis 127.0.0.1:6379> ZINTERSTORE destination numkeys key [key ...] [WEIGHTS weight [weight ...]] [AGGREGATE SUM|MIN|MAX]
保存到目标结果集的的成员数量。
Redis Zscan 命令用于迭代有序集合中的元素(包括元素成员和元素分值)
redis 127.0.0.1:6379> ZSCAN key cursor [MATCH pattern] [COUNT count]
· cursor - 游标。
· pattern - 匹配的模式。
· count - 指定从数据集里返回多少元素,默认值为 10 。
返回的每个元素都是一个有序集合元素,一个有序集合元素由一个成员(member)和一个分值(score)组成。