数据库
首页 > 数据库> > redis--v类型ZSet

redis--v类型ZSet

作者:互联网

ZSet

类型介绍

命令列表

命令原型时间复杂度命令描述返回值
ZADD key score member scoreO(log(N))时间复杂度中的N表示Sorted-Sets中成员的数量。添加参数中指定的所有成员及其分数到指定key的Sorted-Set中,在该命令中我们可以指定多组score/member作为参数。如果在添加时参数中的某一成员已经存在,该命令将更新此成员的分数为新值,同时再将该成员基于新值重新排序。如果键不存在,该命令将为该键创建一个新的Sorted-Sets Value,并将score/member对插入其中。如果该键已经存在,但是与其关联的Value不是Sorted-Sets类型,相关的错误信息将被返回。本次操作实际插入的成员数量。
ZCARD keyO(1)获取与该Key相关联的Sorted-Sets中包含的成员数量。返回Sorted-Sets中的成员数量,如果该Key不存在,返回0。
ZCOUNTkey min maxO(log(N)+M)时间复杂度中的N表示Sorted-Sets中成员的数量,M则表示min和max之间元素的数量。该命令用于获取分数(score)在min和max之间的成员数量。针对min和max参数需要额外说明的是,-inf和+inf分别表示Sorted-Sets中分数的最高值和最低值。缺省情况下,min和max表示的范围是闭区间范围,即min <= score <= max内的成员将被返回。然而我们可以通过在min和max的前面添加"("字符来表示开区间,如(min max表示min < score <= max,而(min (max表示min < score < max。分数指定范围内成员的数量。
ZINCRBYkey increment memberO(log(N))时间复杂度中的N表示Sorted-Sets中成员的数量。该命令将为指定Key中的指定成员增加指定的分数。如果成员不存在,该命令将添加该成员并假设其初始分数为0,此后再将其分数加上increment。如果Key不存,该命令将创建该Key及其关联的Sorted-Sets,并包含参数指定的成员,其分数为increment参数。如果与该Key关联的不是Sorted-Sets类型,相关的错误信息将被返回。以字符串形式表示的新分数。
ZRANGEkey start stop [WITHSCORES]O(log(N)+M)时间复杂度中的N表示Sorted-Set中成员的数量,M则表示返回的成员数量。该命令返回顺序在参数start和stop指定范围内的成员,这里start和stop参数都是0-based,即0表示第一个成员,-1表示最后一个成员。如果start大于该Sorted-Set中的最大索引值,或start > stop,此时一个空集合将被返回。如果stop大于最大索引值,该命令将返回从start到集合的最后一个成员。如果命令中带有可选参数WITHSCORES选项,该命令在返回的结果中将包含每个成员的分数值,如value1,score1,value2,score2…。返回索引在start和stop之间的成员列表。
ZRANGEBYSCORE key min max WITHSCORESO(log(N)+M)时间复杂度中的N表示Sorted-Set中成员的数量,M则表示返回的成员数量。该命令将返回分数在min和max之间的所有成员,即满足表达式min <= score <= max的成员,其中返回的成员是按照其分数从低到高的顺序返回,如果成员具有相同的分数,则按成员的字典顺序返回。可选参数LIMIT用于限制返回成员的数量范围。可选参数offset表示从符合条件的第offset个成员开始返回,同时返回count个成员。可选参数WITHSCORES的含义参照ZRANGE中该选项的说明。最后需要说明的是参数中min和max的规则可参照命令ZCOUNT。返回分数在指定范围内的成员列表。
ZRANK key memberO(log(N))时间复杂度中的N表示Sorted-Set中成员的数量。Sorted-Set中的成员都是按照分数从低到高的顺序存储,该命令将返回参数中指定成员的位置值,其中0表示第一个成员,它是Sorted-Set中分数最低的成员。如果该成员存在,则返回它的位置索引值。否则返回nil。
ZREM key member [member …]O(M log(N))时间复杂度中N表示Sorted-Set中成员的数量,M则表示被删除的成员数量。该命令将移除参数中指定的成员,其中不存在的成员将被忽略。如果与该Key关联的Value不是Sorted-Set,相应的错误信息将被返回。实际被删除的成员数量。
ZREVRANGE key startstop[WITHSCORES]O(log(N)+M)时间复杂度中的N表示Sorted-Set中成员的数量,M则表示返回的成员数量。该命令的功能和ZRANGE基本相同,唯一的差别在于该命令是通过反向排序获取指定位置的成员,即从高到低的顺序。如果成员具有相同的分数,则按降序字典顺序排序。返回指定的成员列表。
ZREVRANKkey memberO(log(N))时间复杂度中的N表示Sorted-Set中成员的数量。该命令的功能和ZRANK基本相同,唯一的差别在于该命令获取的索引是从高到低排序后的位置,同样0表示第一个元素,即分数最高的成员。如果该成员存在,则返回它的位置索引值。否则返回nil。
ZSCOREkey memberO(1)获取指定Key的指定成员的分数。如果该成员存在,以字符串的形式返回其分数,否则返回nil。
ZREVRANGEBYSCOREkey max min WITHSCORESO(log(N)+M)时间复杂度中的N表示Sorted-Set中成员的数量,M则表示返回的成员数量。该命令除了排序方式是基于从高到低的分数排序之外,其它功能和参数含义均与ZRANGEBYSCORE相同。返回分数在指定范围内的成员列表。
ZREMRANGEBYRANKkey start stop O(log(N)+M) 时间复杂度中的N表示Sorted-Set中成员的数量,M则表示被删除的成员数量。删除索引位置位于start和stop之间的成员,start和stop都是0-based,即0表示分数最低的成员,-1表示最后一个成员,即分数最高的成员。 被删除的成员数量。
ZREMRANGEBYSCOREkey min maxO(log(N)+M)时间复杂度中的N表示Sorted-Set中成员的数量,M则表示被删除的成员数量。删除分数在min和max之间的所有成员,即满足表达式min <= score <= max的所有成员。对于min和max参数,可以采用开区间的方式表示,具体规则参照ZCOUNT。被删除的成员数量。

命令实例

添加成员
node01:6379> zadd myzset 1 one
(integer) 1
node01:6379> zadd myzset 2 two 3 three
(integer) 2

查看集合
node01:6379> zrange myzset 0 -1 withscores
1) "one"
2) "1"
3) "two"
4) "2"
5) "three"
6) "3"
zcard myzset
(integer) 3

获取元素的索引值(从0开始)
node01:6379> zrank myzset two
(integer) 1

获取指定得分范围的元素数量
node01:6379> zcount myzset 1 2
(integer) 2
#返回与myzset关联的Sorted-Set中,分数满足表达式1 <= score <= 2的成员的数量

删除指定元素
node01:6379> zrem myzset one two
(integer) 2
node01:6379> zrange myzset 0 -1 withscores
1) "three"
2) "3"
node01:6379> zcard myzset
(integer) 1

操作元素的分数
node01:6379> zscore myzset three
"3"
node01:6379> zscore myzset one
(nil)
node01:6379> zincrby myzset 2 one
"2"
node01:6379> zscore myzset one
"2"
node01:6379> zincrby myzset -1 one
"1"
node01:6379> zscore myzset one
"1"
node01:6379> zrange myzset 0 -1 WITHSCORES
1) "one"
2) "1"
3) "three"
4) "3"

获取指定分数范围的元素
node01:6379> del myzset
(integer) 1
node01:6379> zadd myzset 1 one 2 two 3 three 4 four
(integer) 4
#获取分数满足表达式  []    1 <= score <= 2的成员
node01:6379> zrangebyscore myzset 1 2
1) "one"
2) "two"
#获取分数满足表达式  (]    1 < score <= 2的成员。
node01:6379> zrangebyscore myzset (1 2
1) "two"

删除指定分数范围的元素
node01:6379> zrange myzset 0 -1 WITHSCORES
1) "one"
2) "1"
3) "two"
4) "2"
5) "three"
6) "3"
7) "four"
8) "4"
#删除分数满足表达式1 <= score <= 2的成员
node01:6379> zremrangebyscore myzset 1 2
(integer) 2
node01:6379> zrange myzset 0 -1 WITHSCORES
1) "three"
2) "3"
3) "four"
4) "4"

删除指定索引的元素
#删除位置索引满足表达式0 <= rank <= 1的成员。
node01:6379> zremrangebyrank myzset 0 1
(integer) 2
node01:6379> zrange myzset 0 -1 WITHSCORES
(empty list or set)

逆序--了解
del myzset
zadd myzset 1 one 2 two 3 three 4 four
#以位置索引从高到低的方式获取并返回此区间内的成员。
node01:6379> zrevrange myzset 0 -1 WITHSCORES
1) "four"
2) "4"
3) "three"
4) "3"
5) "two"
6) "2"
7) "one"
8) "1"
#由于是从高到低的排序,所以位置等于0的是four,1是three,并以此类推。

#获取分数满足表达式3 >= score >= 0的成员,并以相反的顺序输出,即从高到底的顺序。
node01:6379> zrevrangebyscore myzset 3 0 WITHSCORES
1) "three"
2) "3"
3) "two"
4) "2"
5) "one"
6) "1"

扩展-应用场景

标签:分数,node01,ZSet,myzset,--,成员,redis,6379,Sorted
来源: https://blog.csdn.net/qq_46893497/article/details/114199391