redis之SortedSet

1.ZADD

ZADD key score member [[score member] [score member] ...]

将一个或多个member元素及其score值加入到有序集key当中。

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

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

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

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

返回值：

被成功添加的新成员的数量，不包括哪些被更新的、已经存在的成员。

命令：

# 添加单个元素redis> ZADD page_rank 10 google.com(integer) 1# 添加多个元素redis> ZADD page_rank 9 baidu.com 8 bing.com(integer) 2redis> ZRANGE page_rank 0 -1 WITHSCORES1) "bing.com"2) "8"3) "baidu.com"4) "9"5) "google.com"6) "10"# 添加已存在元素，且 score 值不变redis> ZADD page_rank 10 google.com(integer) 0redis> ZRANGE page_rank 0 -1 WITHSCORES  # 没有改变1) "bing.com"2) "8"3) "baidu.com"4) "9"5) "google.com"6) "10"# 添加已存在元素，但是改变 score 值redis> ZADD page_rank 6 bing.com(integer) 0redis> ZRANGE page_rank 0 -1 WITHSCORES  # bing.com 元素的 score 值被改变1) "bing.com"2) "6"3) "baidu.com"4) "9"5) "google.com"6) "10"

2.ZCARD

ZCARD key

返回有序集key的基数。

返回值：

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

当key不存在时，返回0。

命令：

redis > ZADD salary 2000 tom    # 添加一个成员(integer) 1redis > ZCARD salary(integer) 1redis > ZADD salary 5000 jack   # 再添加一个成员(integer) 1redis > ZCARD salary(integer) 2redis > EXISTS non_exists_key   # 对不存在的 key 进行 ZCARD 操作(integer) 0redis > ZCARD non_exists_key(integer) 0

3.ZCOUNT

ZCOUNT key min max

返回有序集key中，score值在min和max之间(默认包括score值等于min或max)的成员的数量

返回值：

Score值在min和max之间的成员的数量。

命令：

redis> ZRANGE salary 0 -1 WITHSCORES    # 测试数据1) "jack"2) "2000"3) "peter"4) "3500"5) "tom"6) "5000"redis> ZCOUNT salary 2000 5000          # 计算薪水在 2000-5000 之间的人数(integer) 3redis> ZCOUNT salary 3000 5000          # 计算薪水在 3000-5000 之间的人数(integer) 2

4.ZINCRBY

ZINCRBY key increment member

为有序集key的成员member的score值加上增量increment。

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

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

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

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

返回值：

Member成员的新score值，以字符串形式表示。

命令：

redis> ZSCORE salary tom"2000"redis> ZINCRBY salary 2000 tom   # tom 加薪啦！"4000"

5.ZRANGE

ZRANGE key start stop [WITHSCORES]

返回有序集key中，指定区间内的成员。

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

具有相同score值的成员按字典序来排列。

如果你需要成员按score值递减(从大到小)来排列，请使用ZREVRANGE命令。

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

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

超出范围的下标并不会引起错误：

①比如说，当start的值比有序集的最大下标还要大，或是start>stop时，ZRANGE命令只是简单地返回一个空列表。

②另一方面，假设stop参数的值比有序集的最大下标还有大，那么redis将stop当做最大下标来处理。

可以通过使用WITHSCORES选项，来让成员和它的score值一并返回返回列表以value1,score1,...valueN,scoreN的格式表示。

客户端库可能会返回一些更复杂的数据类型，比如数组、元组等。

返回值：

指定区间内，带有score值(可选)的有序集成员的列表。

命令：

redis > ZRANGE salary 0 -1 WITHSCORES             # 显示整个有序集成员1) "jack"2) "3500"3) "tom"4) "5000"5) "boss"6) "10086"redis > ZRANGE salary 1 2 WITHSCORES    # 显示有序集下标区间 1 至 2 的成员1) "tom"2) "5000"3) "boss"4) "10086"redis > ZRANGE salary 0 200000 WITHSCORES  # 测试 end 下标超出最大下标时的情况1) "jack"2) "3500"3) "tom"4) "5000"5) "boss"6) "10086"redis > ZRANGE salary 200000 3000000 WITHSCORES   # 测试当给定区间不存在于有序集时的情况(empty list or set)

6.ZRANGEBYSCORE

ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT offset count]

返回有序集key中，所有score值介于min和max之间(包括等于min或max)的成员。有序集成员按score值递增(从小到大)次序排列。

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

可选的LIMIT参数指定返回结果的数量及区间(就像SQL中的select limit offset ,count)，注意当offset很大时，定位offset的操作可能需要遍历整个有序集，此过程最坏复杂度为o(N)时间。

区间无极限

Min和max可以是-inf和+inf，这样一来，你就可以在不知道有序集的最低和最高score值的情况下，使用ZRANGEBYSCORE这类命令。

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

举个例子：

ZRANGEBYSCORE zset (1 5 #返回所有符合条件1<score<=5的成员ZRANGEBYSCORE zset (5 (10  #返回所有条件5<score<10的成员

返回值：

指定区间内，带有score值(可选)的有序集成员的列表。

命令：

redis> ZADD salary 2500 jack                        # 测试数据(integer) 0redis> ZADD salary 5000 tom(integer) 0redis> ZADD salary 12000 peter(integer) 0redis> ZRANGEBYSCORE salary -inf +inf               # 显示整个有序集1) "jack"2) "tom"3) "peter"redis> ZRANGEBYSCORE salary -inf +inf WITHSCORES  #显示整个有序集及成员的 score 值1) "jack"2) "2500"3) "tom"4) "5000"5) "peter"6) "12000"redis> ZRANGEBYSCORE salary -inf 5000 WITHSCORES   # 显示工资 <=5000 的所有成员1) "jack"2) "2500"3) "tom"4) "5000"redis> ZRANGEBYSCORE salary (5000 400000 #显示工资大于5000小于等于400000 的成员1) "peter"

7.ZRANK

ZRANK key member

返回有序集key中成员member的排名。其中有序集成员按score值递增(从小到大)顺序排列。

排名以0为底，也就是说，score值最小的成员排名为0。

返回值：

如果member是有序集Key的成员，返回member的排名。

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

命令：

redis> ZRANGE salary 0 -1 WITHSCORES        # 显示所有成员及其 score 值1) "peter"2) "3500"3) "tom"4) "4000"5) "jack"6) "5000"redis> ZRANK salary tom                     # 显示 tom 的薪水排名，第二(integer) 1

8.ZREM

ZREM key member [member...]

移除有序集key中的一个或多个成员，不存在的成员将被忽略。

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

返回值：

被成功移除的成员的数量，不包括被忽略的成员。

命令：

# 测试数据redis> ZRANGE page_rank 0 -1 WITHSCORES1) "bing.com"2) "8"3) "baidu.com"4) "9"5) "google.com"6) "10"# 移除单个元素redis> ZREM page_rank google.com(integer) 1redis> ZRANGE page_rank 0 -1 WITHSCORES1) "bing.com"2) "8"3) "baidu.com"4) "9"# 移除多个元素redis> ZREM page_rank baidu.com bing.com(integer) 2redis> ZRANGE page_rank 0 -1 WITHSCORES(empty list or set)# 移除不存在元素redis> ZREM page_rank non-exists-element(integer) 0

9.ZREMRANGEBYRANK

ZREMRANGEBYRANK key start stop

移除有序集key中，指定排名(rank)区间内的所有成员。

区间分别以下标参数start和stop指出，包括start和stop在内。

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

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

返回值：

被移除成员的数量。

命令：

127.0.0.1:6379> zrange salary 0 -1 withscores1) "jack"2) "2500"3) "tom"4) "5000"5) "peter"6) "25000"127.0.0.1:6379> ZREMRANGEBYRANK salary 0 1 #移除下标0至1区间内的成员(integer) 2127.0.0.1:6379> zrange salary 0 -1 withscores#有序集只剩下一个成员1) "peter"2) "25000"

10.ZREMRANGEBYSCORE

ZREMRANGEBYSCORE key min max

移除有序集key中，所有score值介于min和max之间(包括等于min或max)的成员。

返回值：

被移除成员的数量。

命令：

redis> ZRANGE salary 0 -1 WITHSCORES      # 显示有序集内所有成员及其 score 值1) "tom"2) "2000"3) "peter"4) "3500"5) "jack"6) "5000"redis> ZREMRANGEBYSCORE salary 1500 3500   #移除所有薪水在1500到3500内的员工(integer) 2redis> ZRANGE salary 0 -1 WITHSCORES         # 剩下的有序集成员1) "jack"2) "5000"

11.ZREVRANGE

ZREVRANGE key start stop [WITHSCORES]

返回有序集key中，指定区间内的成员。

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

具有相同score值的成员按字典序的逆序排列

返回值：

指定区间内，带有score值(可选)的有序集成员的列表。

命令：

redis> ZRANGE salary 0 -1 WITHSCORES        # 递增排列1) "peter"2) "3500"3) "tom"4) "4000"5) "jack"6) "5000"redis> ZREVRANGE salary 0 -1 WITHSCORES     # 递减排列1) "jack"2) "5000"3) "tom"4) "4000"5) "peter"6) "3500"

12.ZREVRANGEBYSCORE

ZREVRANGEBYSCORE key max min [WITHSCORES] [LIMIT offset count]

返回有序集key中，score值介于max和min之间(默认包括等于max和min)的所有成员。有序集按score值递减(从大到小)的次序排列。

具有相同score值的成员按字典序的逆序排列。

返回值：

指定区间内，带有score值(可选)的有序集成员的列表。

命令：

redis > ZADD salary 10086 jack(integer) 1redis > ZADD salary 5000 tom(integer) 1redis > ZADD salary 7500 peter(integer) 1redis > ZADD salary 3500 joe(integer) 1redis > ZREVRANGEBYSCORE salary +inf -inf   # 逆序排列所有成员1) "jack"2) "peter"3) "tom"4) "joe"redis > ZREVRANGEBYSCORE salary 10000 2000  # 逆序排列薪水介于 10000 和 2000 之间的成员1) "peter"2) "tom"3) "joe"

13.ZREVRANK

返回有序集key中成员member的排名。其中有序集按score值递减(从大到小)排列。

排名以0为底，也就是说，score值最大的成员排名为0。

返回值：

如果member是有序key的成员，返回member的排名。

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

命令：

redis 127.0.0.1:6379> ZRANGE salary 0 -1 WITHSCORES     # 测试数据1) "jack"2) "2000"3) "peter"4) "3500"5) "tom"6) "5000"redis> ZREVRANK salary peter     # peter 的工资排第二(integer) 1redis> ZREVRANK salary tom       # tom 的工资最高(integer) 0

14.ZSCORE

ZSCORE key member

返回有序集key中，成员member的score值

如果member元素不是有序集key的成员，或key不存在，返回nil。

返回值：

Member成员的score值，以字符串形式表示。

命令：

redis> ZRANGE salary 0 -1 WITHSCORES    # 测试数据1) "tom"2) "2000"3) "peter"4) "3500"5) "jack"6) "5000"redis> ZSCORE salary peter              # 注意返回值是字符串"3500"

15.ZUNIONSTORE

ZUNIONSTORE destination numkeys key [key...] [WEIGHTS weight [weight...]] [AGGREGATE SUM|MIN|MAX]

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

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

WEIGHTS

使用WEIGHTS选项，你可以为每个给定有序集分别指定一个乘法因子，每个给定有序集的所有成员的score值在传递个聚合函数之前都要先乘以该有序集的因子。

如果没有指定WEIGHTS选项，乘法因子默认设置为1。

AGGREGATE

使用AGGREGATE选项，你可以指定并集的结果集的聚合方式。

默认使用的参数SUM,可以将所有集合中某个成员的score值之和作为结果集中该成员的score值；使用参数MIN,可以将所有集合中某个成员的最小score值作为结果集中该成员的score值；而参数max则是将所有集合中某个成员的最大score值作为结果集中该成员的score值。

返回值：

保存到destination的结果集的基数。

命令：

127.0.0.1:6379> zrange pro 0 -1 withscores1) "peter"2) "2000"3) "jack"4) "3500"5) "tom"6) "5000"127.0.0.1:6379> zadd manager 2000 heery 3500 mary 4000 tom(integer) 3127.0.0.1:6379> zrange manager 0 -11) "heery"2) "mary"3) "tom"127.0.0.1:6379> zunionstore salary 2 pro manager weights 1 3  #2代表后面的两个集合 1表示pro*1,表示manager*3(integer) 5127.0.0.1:6379> zrange salary 0 -1 withscores 1) "peter" 2) "2000" 3) "jack" 4) "3500" 5) "heery" 6) "6000" 7) "mary" 8) "10500" 9) "tom"10) "17000"

16.ZINTERSTORE

ZINTERSTORE destination numkeys key [key...] [WEIGHTS weight [weight...]] [AGGREGATE SUM|MIN|MAX]

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

默认情况下，结果集中的某个成员的score值之和。

返回值：

保存到destination的结果集的基数。

命令：

redis > ZADD mid_test 70 "Li Lei"(integer) 1redis > ZADD mid_test 70 "Han Meimei"(integer) 1redis > ZADD mid_test 99.5 "Tom"(integer) 1redis > ZADD fin_test 88 "Li Lei"(integer) 1redis > ZADD fin_test 75 "Han Meimei"(integer) 1redis > ZADD fin_test 99.5 "Tom"(integer) 1redis > ZINTERSTORE sum_point 2 mid_test fin_test(integer) 3redis > ZRANGE sum_point 0 -1 WITHSCORES    # 显示有序集内所有成员及其 score 值1) "Han Meimei"2) "145"3) "Li Lei"4) "158"5) "Tom"6) "199"

17.ZRANGEBYLEX

ZRANGEBYLEX key min max [LIMIT offset count]

当有序集合的所有成员都具有相同的分值时，有序集合的元素会根据成员的字典序来进行排序，而这个命令则可以返回给定的有序集合键key中，值介于min和max之间的成员。

如果有序集合里面的成员带有不同的分值，那么命令返回的结果是未指定的。

命令会使用C语言的memcmp()函数，对集合中的每个成员进行逐个字节的对比，并按照从低到高的顺序，返回排序后的集合成员。如果两个字符串有一部分内容是相同的话，那么命令会认为较长的字符串比较短的字符串要大。

可选的LIMIT offset count参数用于获取指定范围内的匹配元素(就像SQL中的SELECT LIMIT offset count语句)。需要注意的一点是，如果offset参数值非常大的话，那么命令在返回之前，需要先遍历至offset所指定的位置，这个操作会为命令加上最多o(N)复杂度。

如何指定范围之间

合法的min和max参数必须包含(或者[,即一个开区间一个闭区间。

特殊值+和-在min参数以及max参数中具有特殊的一样，其中+表示正无限，而-表示负无限。因此，向一个所有成员的分值都相同的有序集合发送命令ZRANGEBYLEX <zset> - +,命令将返回有序集合中的所有元素。

返回值：

数组回复：一个列表，列表里面包含了有序集合在指定范围内的成员。

命令：

redis> ZADD myzset 0 a 0 b 0 c 0 d 0 e 0 f 0 g(integer) 7redis> ZRANGEBYLEX myzset - [c1) "a"2) "b"3) "c"redis> ZRANGEBYLEX myzset - (c1) "a"2) "b"redis> ZRANGEBYLEX myzset [aaa (g #aaa比a要大1) "b"2) "c"3) "d"4) "e"5) "f"

18.ZLEXCOUNT

ZLEXCOUNT key min max

对于一个所有成员的分值都相同的有序集合键key来说，这个命令会返回该集合中，成员介于min和max范围内的元素数量。

返回值：

整数回复：指定范围内元素的数量。

命令：

redis> ZADD myzset 0 a 0 b 0 c 0 d 0 e 0 f 0 g(integer) 7redis> ZLEXCOUNT myzset - +(integer) 7redis> ZLEXCOUNT myzset [b [f(integer) 5

19.ZREMRANGEBYLEX

ZREMRANGEBYLEX key min max

对于一个所有成员的分值都相同的有序集合键key来说，这个命令会移除该集合中，成员介于min和max范围内的所有元素。

返回值：

整数回复：被移除的元素的数量。

命令：

redis> ZADD myzset 0 aaaa 0 b 0 c 0 d 0 e(integer) 5redis> ZADD myzset 0 foo 0 zap 0 zip 0 ALPHA 0 alpha(integer) 5redis> ZRANGE myzset 0 -11) "ALPHA"2) "aaaa"3) "alpha"4) "b"5) "c"6) "d"7) "e"8) "foo"9) "zap"10) "zip"redis> ZREMRANGEBYLEX myzset [alpha [omega(integer) 6redis> ZRANGE myzset 0 -11) "ALPHA"2) "aaaa"3) "zap"4) "zip"