redis教程Redis有序集合(十一)

1、Redis 有序集合和集合一样也是string类型元素的集合,且不允许重复的成员。
2、不同的是每个元素都会关联一个double类型的分数。redis正是通过分数来为集合中的成员进行从小到大的排序。
3、有序集合的成员是唯一的,但分数(score)却可以重复。
4、集合是通过哈希表实现的，所以添加，删除，查找的复杂度都是O(1)。 集合中最大的成员数为 232 - 1 (4294967295, 每个集合可存储40多亿个成员)

Redis 有序集合命令

• 下表列出了 redis 有序集合的基本命令

1、ZADD key score1 member1 [score2 member2] 
	向有序集合添加一个或多个成员，或者更新已存在成员的分数
2、ZCARD key 	获取有序集合的成员数
3、ZCOUNT key min max 
	计算在有序集合中指定区间分数的成员数
4、ZINCRBY key increment member 
	有序集合中对指定成员的分数加上增量 increment
5、ZINTERSTORE destination numkeys key [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 ...] 
	计算给定的一个或多个有序集的并集，并存储在新的 key 中
20、ZSCAN key cursor [MATCH pattern] [COUNT count] 
	迭代有序集合中的元素（包括元素成员和元素分值）

命令的详细介绍

• Redis Zadd 命令

1、Redis Zadd 命令用于将一个或多个成员元素及其分数值加入到有序集当中。
2、如果某个成员已经是有序集的成员，那么更新这个成员的分数值，并通过重新插入这个成员元素，来保证该成员在正确的位置上。
3、分数值可以是整数值或双精度浮点数。
4、如果有序集合 key 不存在，则创建一个空的有序集并执行 ZADD 操作。
当 key 存在但不是有序集类型时，返回一个错误。
5、注意： 在 Redis 2.4 版本以前， ZADD 每次只能添加一个元素。
6、返回值：被成功添加的新成员的数量，不包括那些被更新的、已经存在的成员。

127.0.0.1:6379> zadd firstzset 1 "swk"
(integer) 1
127.0.0.1:6379> zadd firstzset 1 "ts"
(integer) 1
127.0.0.1:6379> zadd firstzset 2 "ss" 3 "bj"
(integer) 2
127.0.0.1:6379> zrange firstzset 0 -1 
1) "swk"
2) "ts"
3) "ss"
4) "bj"
127.0.0.1:6379> zrange firstzset 0 -1 withscores
1) "swk"
2) "1"
3) "ts"
4) "1"
5) "ss"
6) "2"
7) "bj"
8) "3"
127.0.0.1:6379>

• Redis Zcard 命令

1、Redis Zcard 命令用于计算集合中元素的数量。
2、返回值：当 key 存在且是有序集类型时，返回有序集的基数。 当 key 不存在时，返回 0 。

127.0.0.1:6379> zcard firstzset
(integer) 4
127.0.0.1:6379> zcard secondzset
(integer) 0

• Redis Zcount 命令

1、Redis Zcount 命令用于计算有序集合中指定分数区间的成员数量。
2、返回值：分数值在 min 和 max 之间的成员的数量。

127.0.0.1:6379> zcount firstzset 1 2
(integer) 3

• Redis Zincrby 命令

1、Redis Zincrby 命令对有序集合中指定成员的分数加上增量 increment
2、可以通过传递一个负数值 increment ，让分数减去相应的值，比如 ZINCRBY key -5 member ，就是让 member 的 score 值减去 5 。
3、当 key 不存在，或分数不是 key 的成员时， ZINCRBY key increment member 等同于 ZADD key increment member 。
4、当 key 不是有序集类型时，返回一个错误。
5、分数值可以是整数值或双精度浮点数。
6、返回值：member 成员的新分数值，以字符串形式表示。

127.0.0.1:6379> zincrby firstzset 5 "ss"
"7"
127.0.0.1:6379> zrange firstzset 0 -1 withscores
1) "swk"
2) "1"
3) "ts"
4) "1"
5) "bj"
6) "3"
7) "ss"
8) "7"

• Redis Zinterstore 命令

1、Redis Zinterstore 命令计算给定的一个或多个有序集的交集，其中给定 key 的数量必须以 numkeys 参数指定，并将该交集(结果集)储存到 destination 。
2、默认情况下，结果集中某个成员的分数值是所有给定集下该成员分数值之和。
3、返回值：保存到目标结果集的的成员数量。

127.0.0.1:6379> zadd first 70 "chinese" 80  "math" 100 "english"
(integer) 3
127.0.0.1:6379> zadd second 100 "chinese" 80  "math" 100 "english"
(integer) 3
127.0.0.1:6379> zinterstore totalPoint 2 first second
(integer) 3
127.0.0.1:6379> zrange totalPoint 0 -1 withscores
1) "math"
2) "160"
3) "chinese"
4) "170"
5) "english"
6) "200"

• Redis Zlexcount 命令

1、Redis Zlexcount 命令在计算有序集合中指定字典区间内成员数量。
2、返回值：指定区间内的成员数量。

127.0.0.1:6379> zadd third 0 a 0 b 0 c 0 d 0 e
(integer) 5
127.0.0.1:6379> zadd third 0 f 0 g
(integer) 2
127.0.0.1:6379> zlexcount third - +
(integer) 7
127.0.0.1:6379> zlexcount third  [e [f
(integer) 2

• Redis Zrange 命令

1、Redis Zrange 返回有序集中，指定区间内的成员。
其中成员的位置按分数值递增(从小到大)来排序。
具有相同分数值的成员按字典序(lexicographical order )来排列。
如果你需要成员按值递减(从大到小)来排列，请使用 ZREVRANGE 命令。
2、下标参数 start 和 stop 都以 0 为底，也就是说，以 0 表示有序集第一个成员，以 1 表示有序集第二个成员，以此类推。
3、你也可以使用负数下标，以 -1 表示最后一个成员， -2 表示倒数第二个成员，以此类推。
4、返回值：指定区间内，带有分数值(可选)的有序集成员的列表。

127.0.0.1:6379> zrange monthsalary 0 -1 withscores
1) "xx"
2) "1000"
3) "wwj"
4) "2000"
5) "zjh"
6) "10000"
127.0.0.1:6379> zrange monthsalary 1 2  withscores
1) "wwj"
2) "2000"
3) "zjh"
4) "10000"
127.0.0.1:6379> zrange monthsalary 100 2  withscores
(empty list or set)

• Redis Zrangebylex 命令

1、Redis Zrangebylex 通过字典区间返回有序集合的成员。
2、返回值：指定区间内的元素列表。

127.0.0.1:6379> zadd testset 0 a 0 b 0 c 0 d 0 e 0 f 0 g
(integer) 7
127.0.0.1:6379> zrangebylex testset - [c
1) "a"
2) "b"
3) "c"
127.0.0.1:6379> zrangebylex testset - (c
1) "a"
2) "b"
127.0.0.1:6379> zrangebylex testset  [ddd (g
1) "e"
2) "f"

• Redis Zrangebyscore 命令

1、Redis Zrangebyscore 返回有序集合中指定分数区间的成员列表。有序集成员按分数值递增(从小到大)次序排列。
2、具有相同分数值的成员按字典序来排列(该属性是有序集提供的，不需要额外的计算)。
3、默认情况下，区间的取值使用闭区间 (小于等于或大于等于)，你也可以通过给参数前增加 ( 符号来使用可选的开区间 (小于或大于)。
举个例子：
ZRANGEBYSCORE zset (1 5
返回所有符合条件 1 < score <= 5 的成员，而
ZRANGEBYSCORE zset (5 (10
则返回所有符合条件 5 < score < 10 的成员。
4、返回值：指定区间内，带有分数值(可选)的有序集成员的列表。

127.0.0.1:6379> zadd salary 10000 "gz" 15000 "zt" 20000 "sunwukong" 25000  "xx" 
(integer) 4
127.0.0.1:6379> zrangebyscore salary -inf +inf
1) "gz"
2) "zt"
3) "sunwukong"
4) "xx"
127.0.0.1:6379> zrangebyscore salary -inf +inf withscores
1) "gz"
2) "10000"
3) "zt"
4) "15000"
5) "sunwukong"
6) "20000"
7) "xx"
8) "25000"
127.0.0.1:6379> zrangebyscore salary -inf 15000 withscores
1) "gz"
2) "10000"
3) "zt"
4) "15000"
127.0.0.1:6379> zrangebyscore salary (15000 20000
1) "sunwukong" 

• Redis Zrank 命令

1、Redis Zrank 返回有序集中指定成员的排名。其中有序集成员按分数值递增(从小到大)顺序排列。
2、返回值：如果成员是有序集 key 的成员，返回 member 的排名。 如果成员不是有序集 key 的成员，返回 nil 。

127.0.0.1:6379> zrange salary 0 -1 withscores
1) "gz"
2) "10000"
3) "zt"
4) "15000"
5) "sunwukong"
6) "20000"
7) "xx"
8) "25000"
127.0.0.1:6379> zrank salary sunwukong
(integer) 2

• Redis Zrem 命令

1、Redis Zrem 命令用于移除有序集中的一个或多个成员，不存在的成员将被忽略。
2、当 key 存在但不是有序集类型时，返回一个错误。
注意： 在 Redis 2.4 版本以前， ZREM 每次只能删除一个元素。
3、返回值：被成功移除的成员的数量，不包括被忽略的成员。

127.0.0.1:6379> zrange salary 0 -1 withscores
1) "gz"
2) "10000"
3) "zt"
4) "15000"
5) "sunwukong"
6) "20000"
7) "xx"
8) "25000"
127.0.0.1:6379> zrem salary gz
(integer) 1
127.0.0.1:6379> zrange salary 0 -1 withscores
1) "zt"
2) "15000"
3) "sunwukong"
4) "20000"
5) "xx"
6) "25000"
127.0.0.1:6379> zrem salary zt sunwukong 
(integer) 2
127.0.0.1:6379> zrange salary 0 -1 withscores
1) "xx"
2) "25000"
127.0.0.1:6379> zrem salary test
(integer) 0

• Redis Zremrangebylex 命令

1、Redis Zremrangebylex 命令用于移除有序集合中给定的字典区间的所有成员。
2、返回值：被成功移除的成员的数量，不包括被忽略的成员。

127.0.0.1:6379> zadd myzset 0 aaaa 0 b 0 c 0 d 0 e 0 foo 0 zap 0 zip 0 alpha 0 ALPHA
(integer) 10
127.0.0.1:6379> zrange myzset 0 -1
 1) "ALPHA"
 2) "aaaa"
 3) "alpha"
 4) "b"
 5) "c"
 6) "d"
 7) "e"
 8) "foo"
 9) "zap"
10) "zip"
127.0.0.1:6379> zremrangebylex myzset [alpha [omega
(integer) 6
127.0.0.1:6379> zrange myzset 0 -1
1) "ALPHA"
2) "aaaa"
3) "zap"
4) "zip"

• Redis Zremrangebyrank 命令

1、Redis Zremrangebyrank 命令
2、返回值：被移除成员的数量。

127.0.0.1:6379> zrange myzset 0 -1
1) "ALPHA"
2) "aaaa"
3) "zap"
4) "zip"
127.0.0.1:6379> zremrangebyrank myzset 0 3
(integer) 4

• Redis Zremrangebyscore 命令

1、Redis Zremrangebyscore 命令用于移除有序集中，指定分数（score）区间内的所有成员。
2、返回值：被移除成员的数量。

127.0.0.1:6379> zrange salary 0 -1 withscores
1) "sunwukong"
2) "10000"
3) "linchong"
4) "12000"
5) "xx"
6) "25000"
127.0.0.1:6379> zremrangebyscore salary 10000 15000
(integer) 2
127.0.0.1:6379> zrange salary 0 -1 withscores
1) "xx"
2) "25000"

• Redis Zrevrange 命令

1、Redis Zrevrange 命令返回有序集中，指定区间内的成员。
2、其中成员的位置按分数值递减(从大到小)来排列。
3、具有相同分数值的成员按字典序的逆序(reverse lexicographical order)排列。
4、除了成员按分数值递减的次序排列这一点外， ZREVRANGE 命令的其他方面和 ZRANGE 命令一样。
5、返回值：指定区间内，带有分数值(可选)的有序集成员的列表。

127.0.0.1:6379> zrange salary 0 -1 withscores
1) "sunwukong"
2) "10000"
3) "linchong"
4) "12000"
5) "xx"
6) "25000"
127.0.0.1:6379> zrevrange salary 0 -1 withscores
1) "xx"
2) "25000"
3) "linchong"
4) "12000"
5) "sunwukong"
6) "10000"

• Redis Zrevrangebyscore 命令

1、Redis Zrevrangebyscore 返回有序集中指定分数区间内的所有的成员。有序集成员按分数值递减(从大到小)的次序排列。
2、具有相同分数值的成员按字典序的逆序(reverse lexicographical order )排列。
除了成员按分数值递减的次序排列这一点外， ZREVRANGEBYSCORE 命令的其他方面和 ZRANGEBYSCORE 命令一样。
3、返回值：指定区间内，带有分数值(可选)的有序集成员的列表。

127.0.0.1:6379> zrange salary 0 -1 withscores
1) "sunwukong"
2) "10000"
3) "linchong"
4) "12000"
5) "xx"
6) "25000"
7) "zhangwuji"
8) "30000"
127.0.0.1:6379> zrevrangebyscore salary 25000 10000
1) "xx"
2) "linchong"
3) "sunwukong"

• Redis Zrevrank 命令

1、Redis Zrevrank 命令返回有序集中成员的排名。其中有序集成员按分数值递减(从大到小)排序。
排名以 0 为底，也就是说， 分数值最大的成员排名为 0 。
2、使用 ZRANK 命令可以获得成员按分数值递增(从小到大)排列的排名。
3、返回值：如果成员是有序集 key 的成员，返回成员的排名。 如果成员不是有序集 key 的成员，返回 nil 。

127.0.0.1:6379> zrange salary 0 -1 withscores
1) "sunwukong"
2) "10000"
3) "linchong"
4) "12000"
5) "xx"
6) "25000"
7) "zhangwuji"
8) "30000"
127.0.0.1:6379> zrevrank salary xx
(integer) 1

• Redis Zscore 命令

1、Redis Zscore 命令返回有序集中，成员的分数值。 如果成员元素不是有序集 key 的成员，或 key 不存在，返回 nil 。
2、成员的分数值，以字符串形式表示。

127.0.0.1:6379> zscore salary xx
"25000"

• Redis Zunionstore 命令

1、Redis Zunionstore 命令计算给定的一个或多个有序集的并集，其中给定 key 的数量必须以 numkeys 参数指定，并将该并集(结果集)储存到 destination 。
2、默认情况下，结果集中某个成员的分数值是所有给定集下该成员分数值之和 。
语法
redis Zunionstore 命令基本语法如下：
redis 127.0.0.1:6379> ZUNIONSTORE destination numkeys key [key ...] [WEIGHTS weight [weight ...]] [AGGREGATE SUM|MIN|MAX]
3、保存到 destination 的结果集的成员数量。

127.0.0.1:6379> zadd yitiantulongji 1000 "zhangwuji" 2000 "zhaomin" 
(integer) 2
127.0.0.1:6379> zadd tianlongbabu 2000 "qiaofeng" 1500 "xuzhu"
(integer) 2
127.0.0.1:6379> zunionstore ty 2 yitiantulongji tianlongbabu weights 1 3
(integer) 4
127.0.0.1:6379> zrange ty 0 -1 withscores
1) "zhangwuji"
2) "1000"
3) "zhaomin"
4) "2000"
5) "xuzhu"
6) "4500"
7) "qiaofeng"
8) "6000"

• Redis Zscan 命令

1、Redis Zscan 命令用于迭代有序集合中的元素（包括元素成员和元素分值）
2、语法：
redis 127.0.0.1:6379> ZSCAN key cursor [MATCH pattern] [COUNT count]
3、返回值：返回的每个元素都是一个有序集合元素，一个有序集合元素由一个成员（member）和一个分值（score）组成。

127.0.0.1:6379> zscan ty 0 match q*
1) "0"
2) 1) "qiaofeng"
   2) "6000"
   3) "qiaoqiao"
   4) "10000"