redis之SortedSet

    xiaoxiao2021-12-14  22

    1.ZADD

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

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

    如果某个member已经是有序集的成员,那么更新这个memberscore值,并通过重新插入这个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) 2 redis> 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 10 google.com (integer) 0 redis> 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) 0 redis> 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) 1 redis > ZCARD salary (integer) 1 redis > ZADD salary 5000 jack # 再添加一个成员 (integer) 1 redis > ZCARD salary (integer) 2 redis > EXISTS non_exists_key # 对不存在的 key 进行 ZCARD 操作 (integer) 0 redis > ZCARD non_exists_key (integer) 0 3.ZCOUNT

    ZCOUNT key min max

    返回有序集key中,score值在minmax之间(默认包括score值等于minmax)的成员的数量

    返回值:

    Score值在minmax之间的成员的数量。

    命令:

    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) 3 redis> ZCOUNT salary 3000 5000 # 计算薪水在 3000-5000 之间的人数 (integer) 2 4.ZINCRBY

    ZINCRBY key increment member

    为有序集key的成员memberscore值加上增量increment

    可以通过传递一个负数值increment,让score减去相应的值,比如 ZINCRBY key -5 member,就是让memberscore值减去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命令。

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

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

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

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

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

    可以通过使用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值介于minmax之间(包括等于minmax)的成员。有序集成员按score值递增(从小到大)次序排列。

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

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

    区间无极限

    Minmax可以是-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) 0 redis> ZADD salary 5000 tom (integer) 0 redis> ZADD salary 12000 peter (integer) 0 redis> 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 WITHSCORES 1) "bing.com" 2) "8" 3) "baidu.com" 4) "9" 5) "google.com" 6) "10" # 移除单个元素 redis> ZREM page_rank google.com (integer) 1 redis> ZRANGE page_rank 0 -1 WITHSCORES 1) "bing.com" 2) "8" 3) "baidu.com" 4) "9" # 移除多个元素 redis> ZREM page_rank baidu.com bing.com (integer) 2 redis> 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)区间内的所有成员。

    区间分别以下标参数startstop指出,包括startstop在内。

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

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

    返回值:

    被移除成员的数量。

    命令:

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

    ZREMRANGEBYSCORE key min max

    移除有序集key中,所有score值介于minmax之间(包括等于minmax)的成员。

    返回值:

    被移除成员的数量。

    命令:

    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) 2 redis> 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值介于maxmin之间(默认包括等于maxmin)的所有成员。有序集按score值递减(从大到小)的次序排列。

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

    返回值:

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

    命令:

    redis > ZADD salary 10086 jack (integer) 1 redis > ZADD salary 5000 tom (integer) 1 redis > ZADD salary 7500 peter (integer) 1 redis > ZADD salary 3500 joe (integer) 1 redis > 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) 1 redis> ZREVRANK salary tom # tom 的工资最高 (integer) 0 14.ZSCORE

    ZSCORE key member

    返回有序集key中,成员memberscore

    如果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 withscores 1) "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) 3 127.0.0.1:6379> zrange manager 0 -1 1) "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) 5 127.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) 1 redis > ZADD mid_test 70 "Han Meimei" (integer) 1 redis > ZADD mid_test 99.5 "Tom" (integer) 1 redis > ZADD fin_test 88 "Li Lei" (integer) 1 redis > ZADD fin_test 75 "Han Meimei" (integer) 1 redis > ZADD fin_test 99.5 "Tom" (integer) 1 redis > ZINTERSTORE sum_point 2 mid_test fin_test (integer) 3 redis > 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中,值介于minmax之间的成员。

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

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

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

    如何指定范围之间

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

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

    返回值:

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

    命令:

    redis> ZADD myzset 0 a 0 b 0 c 0 d 0 e 0 f 0 g (integer) 7 redis> ZRANGEBYLEX myzset - [c 1) "a" 2) "b" 3) "c" redis> ZRANGEBYLEX myzset - (c 1) "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来说,这个命令会返回该集合中,成员介于minmax范围内的元素数量。

    返回值:

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

    命令:

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

    ZREMRANGEBYLEX key min max

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

    返回值:

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

    命令:

    redis> ZADD myzset 0 aaaa 0 b 0 c 0 d 0 e (integer) 5 redis> ZADD myzset 0 foo 0 zap 0 zip 0 ALPHA 0 alpha (integer) 5 redis> ZRANGE myzset 0 -1 1) "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) 6 redis> ZRANGE myzset 0 -1 1) "ALPHA" 2) "aaaa" 3) "zap" 4) "zip"

    转载请注明原文地址: https://ju.6miu.com/read-971983.html

    最新回复(0)