Redis 有序集合(sorted set)
Redis 有序集合(sorted set)
Redis 有序集合和集合一样也是 string 类型元素的集合,且不允许重复的成员。
不同的是每个元素都会关联一个 double 类型的分数。redis 正是通过分数来为集合中的成员进行从小到大的排序。
有序集合的成员是唯一的,但分数(score)却可以重复。
集合是通过哈希表实现的，所以添加，删除，查找的复杂度都是 O(1)。 集合中最大的成员数为 232 - 1 (4294967295, 每个集合可存储40多亿个成员)。
实例
> zadd sset 10 redis 20 mongodb 30 kafka
3
> zrange sset 0 100 withscores
redis
10
mongodb
20
kafka
30
Redis 有序集合命令
1、Zadd
Redis Zadd 命令用于将一个或多个成员元素及其分数值加入到有序集当中。
如果某个成员已经是有序集的成员，那么更新这个成员的分数值，并通过重新插入这个成员元素，来保证该成员在正确的位置上。
分数值可以是整数值或双精度浮点数。
如果有序集合 key 不存在，则创建一个空的有序集并执行 ZADD 操作。
当 key 存在但不是有序集类型时，返回一个错误。
注意： 在 Redis 2.4 版本以前， ZADD 每次只能添加一个元素。
语法
> ZADD KEY_NAME SCORE1 VALUE1.. SCOREN VALUEN
返回值
被成功添加的新成员的数量，不包括那些被更新的、已经存在的成员。
实例
> zadd sset 10 redis 20 mongodb 30 kafka
3
2、Zcard
Redis Zcard 命令用于计算集合中元素的数量。
语法
> ZCARD KEY_NAME
返回值
当 key 存在且是有序集类型时，返回有序集的基数。 当 key 不存在时，返回 0 。
实例
> zcard sset
3
3、Zcount
Redis Zcount 命令用于计算有序集合中指定分数区间的成员数量。
语法
> ZCOUNT key min max
返回值
分数值在 min 和 max 之间的成员的数量。
实例
> zcount sset 1 100
3
4、Zincrby
Redis Zincrby 命令对有序集合中指定成员的分数加上增量 increment
可以通过传递一个负数值 increment ，让分数减去相应的值，比如 ZINCRBY key -5 member ，就是让 member 的 score 值减去 5 。
当 key 不存在，或分数不是 key 的成员时， ZINCRBY key increment member 等同于 ZADD key increment member 。
当 key 不是有序集类型时，返回一个错误。
分数值可以是整数值或双精度浮点数。
语法
> SET KEY_NAME VALUE
返回值
member 成员的新分数值，以字符串形式表示。
实例
> zrange sset 0 100 withscores
redis
10
mongodb
20
kafka
30
> zincrby sset 10 redis
20
> zrange sset 0 100 withscores
mongodb
20
redis
20
kafka
30
5、Zinterstore
Redis Zinterstore 命令计算给定的一个或多个有序集的交集，其中给定 key 的数量必须以 numkeys 参数指定，并将该交集(结果集)储存到 destination 。
默认情况下，结果集中某个成员的分数值是所有给定集下该成员分数值之和。
语法
> ZINTERSTORE destination numkeys key [key ...] [WEIGHTS weight [weight ...]] [AGGREGATE SUM|MIN|MAX]
返回值
保存到目标结果集的的成员数量。
实例
> zadd zset1 10 redis 10 mongodb 10 clickhouse
3
> zadd zset2 15 redis 12 mongodb 16 clickhouse
3
> zinterstore zset3 2 zset1 zset2
3
> zrange zset3 0 -1 withscores
mongodb
22
redis
25
clickhouse
26
6、Zcount
Redis Zlexcount 命令在计算有序集合中指定字典区间内成员数量。
字典区间就是两个参数在英文字典（lexic）中的排序位置所形成的区间，查询哪些member落在区间内。但这个查询是从左到右（zset的score排序）按照两个参数进行定位的。第一个参数不能大于zset最右member，否则会返回错误。
语法
>zlexcount zset [memberMin [memberMax
- memberMin排名较小的成员
- memberMax排名较大的成员
- 成员名称前需要加
[符号作为开头,[符号与成员之间不能有空格 - 可以使用
-和+表示得分最小值和最大值 min和max不能反,max放前面min放后面会导致返回结果为0- 计算成员之间的成员数量时,参数
min和max的位置也计算在内。 min和max参数的含义与zrangebylex命令中所描述的相同
返回值
有序集合中成员名称 min 和 max 之间的成员数量; Integer类型。
实例
> zlexcount zset1 - +
3
7、Zrange
Redis Zrange 返回有序集中，指定区间内的成员。
其中成员的位置按分数值递增(从小到大)来排序。
具有相同分数值的成员按字典序(lexicographical order )来排列。
如果你需要成员按
值递减(从大到小)来排列，请使用 ZREVRANGE 命令。
下标参数 start 和 stop 都以 0 为底，也就是说，以 0 表示有序集第一个成员，以 1 表示有序集第二个成员，以此类推。
你也可以使用负数下标，以 -1 表示最后一个成员， -2 表示倒数第二个成员，以此类推。
语法
> ZRANGE key start stop [WITHSCORES]
返回值
指定区间内，带有分数值(可选)的有序集成员的列表。
实例
> zadd zset 10 redis 11 kafka 12 lu
3
> zrange zset 0 10
redis
kafka
lu
> zrange zset 0 -1
redis
kafka
lu
> zrange zset 0 -2
redis
kafka
> zrevrange zset 0 -1
lu
kafka
redis
8、Zrangebylex
Redis Zrangebylex 通过字典区间返回有序集合的成员
语法
> ZRANGEBYLEX key min max [LIMIT offset count]
返回值
指定区间内的元素列表。
实例
> ZRANGEBYLEX zset [a (z
redis
kafka
lu
9、Zrangebyscore
Redis Zrangebyscore 返回有序集合中指定分数区间的成员列表。有序集成员按分数值递增(从小到大)次序排列。
具有相同分数值的成员按字典序来排列(该属性是有序集提供的，不需要额外的计算)。
默认情况下，区间的取值使用闭区间 (小于等于或大于等于)，你也可以通过给参数前增加 ( 符号来使用可选的开区间 (小于或大于)。
语法
> ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT offset count]
相当于mysql
- offset偏移量
- 取多少条
返回值
SET 在设置操作成功完成时，才返回 OK 。
实例
> zrangebyscore zset 0 100 withscores limit 0 2
redis
10
kafka
11
10、Zrank
Redis Zrank 返回有序集中指定成员的排名。其中有序集成员按分数值递增(从小到大)顺序排列。
语法
> SET KEY_NAME VALUE
返回值
SET 在设置操作成功完成时，才返回 OK 。
实例
> zrange zset 0 -1 withscores
redis
10
kafka
11
lu
12
> zrank zset lua
null
> zrank zset lu
2
11、Zrem
Redis Zrem 命令用于移除有序集中的一个或多个成员，不存在的成员将被忽略。
当 key 存在但不是有序集类型时，返回一个错误。
注意： 在 Redis 2.4 版本以前， ZREM 每次只能删除一个元素。
语法
> ZREM key member [member ...]
返回值
被成功移除的成员的数量，不包括被忽略的成员。
实例
> zrem zset lu
1
12、Zremrangebylex
Redis Zremrangebylex 命令用于移除有序集合中给定的字典区间的所有成员。
语法
> ZREMRANGEBYLEX key min max
返回值
被成功移除的成员的数量，不包括被忽略的成员。
实例
> zremrangebylex zset [a [z
2
13、Zremrangebyrank
Redis Zremrangebyrank 命令用于移除有序集中，指定排名(rank)区间内的所有成员。
语法
> ZREMRANGEBYRANK key start stop
返回值
被移除成员的数量。
实例
> zadd salary 1200 tom 5000 cat 3500 jack
3
> zremrangebyrank salary 0 1
2
> zrange salary 0 -1 withscores
cat
5000
14、Zremrangebyscore
Redis Zremrangebyscore 命令用于移除有序集中，指定分数（score）区间内的所有成员。
语法
> ZREMRANGEBYSCORE key min max
返回值
被移除成员的数量。
实例
> zremrangebyscore salary 1500 10000
1
> zrange salary 0 -1 withscores
15、Zrevrange
Redis Zrevrange 命令返回有序集中，指定区间内的成员。
其中成员的位置按分数值递减(从大到小)来排列。
具有相同分数值的成员按字典序的逆序(reverse lexicographical order)排列。
除了成员按分数值递减的次序排列这一点外， ZREVRANGE 命令的其他方面和ZRANGE 命令一样。
语法
> ZREVRANGE key start stop [WITHSCORES]
返回值
指定区间内，带有分数值(可选)的有序集成员的列表。
实例
> zadd salary 1200 tom 5000 cat 3500 jack
3
> zrange salary 0 -1 withscores
tom
1200
jack
3500
cat
5000
> zrevrange salary 0 -1 withscores
cat
5000
jack
3500
tom
1200
16、Zrevrangebyscore
Redis Zrevrangebyscore 返回有序集中指定分数区间内的所有的成员。有序集成员按分数值递减(从大到小)的次序排列。
具有相同分数值的成员按字典序的逆序(reverse lexicographical order )排列。
除了成员按分数值递减的次序排列这一点外， ZREVRANGEBYSCORE 命令的其他方面和 ZRANGEBYSCORE命令一样。
语法
> ZREVRANGEBYSCORE key max min [WITHSCORES] [LIMIT offset count]
返回值
指定区间内，带有分数值(可选)的有序集成员的列表。
实例
> zrevrangebyscore salary 1000 10000
> zrevrangebyscore salary 10000 1000
cat
jack
tom
> zrevrangebyscore salary +inf -inf
cat
jack
tom
17、Zrevrank
Redis Zrevrank 命令返回有序集中成员的排名。其中有序集成员按分数值递减(从大到小)排序。
排名以 0 为底，也就是说， 分数值最大的成员排名为 0 。
使用 ZRANK 命令可以获得成员按分数值递增(从小到大)排列的排名。
语法
> ZREVRANK key member
返回值
如果成员是有序集 key 的成员，返回成员的排名。 如果成员不是有序集 key 的成员，返回 nil 。
实例
> zrevrank salary tom
2
18、Zscore
Redis Zscore 命令返回有序集中，成员的分数值。 如果成员元素不是有序集 key 的成员，或 key 不存在，返回 nil 。
语法
> ZSCORE key member
返回值
成员的分数值，以字符串形式表示。
实例
> zscore salary jack
3500
19、Zunionstore
Redis Zunionstore 命令计算给定的一个或多个有序集的并集，其中给定 key 的数量必须以 numkeys 参数指定，并将该并集(结果集)储存到 destination 。
默认情况下，结果集中某个成员的分数值是所有给定集下该成员分数值之和 。
语法
> ZUNIONSTORE destination numkeys key [key ...] [WEIGHTS weight [weight ...]] [AGGREGATE SUM|MIN|MAX]
返回值
保存到 destination 的结果集的成员数量。
实例
>ZUNIONSTORE out 2 zset1 zset2 WEIGHTS 2 3
20、Zscan
Redis Zscan 命令用于迭代有序集合中的元素（包括元素成员和元素分值）
语法
> ZSCAN key cursor [MATCH pattern] [COUNT count]
- cursor - 游标。
- pattern - 匹配的模式。
- count - 指定从数据集里返回多少元素，默认值为 10 。
返回值
返回的每个元素都是一个有序集合元素，一个有序集合元素由一个成员（member）和一个分值（score）组成。
实例
ZSCAN site 0 match "R*"
