redis有序集合相关命令

谁借莪１个温暖的怀抱￠ 2022-06-05 02:22 265阅读 0赞

## 前言 ##

redis有序集合和集合一样也是string类型元素的集合，且不允许重复的成员。不同的是每个元素都会关联一个double类型的分数。redis通过分数为集合中的元素从小到大排序。  
有序集合的成员是唯一的，但是分数（score）是可以重复的。  
集合是通过哈希表实现的，所以添加、删除查找的复杂度都是O(1)。

## 命令 ##

**1、zadd命令-向有序集合添加一个或多个元素，或者更新已经存在成员的分数。**  
redis中zadd命令用于将一个或多个成员元素及其分数值加入到有序集合中。  
如果某个成员已经是有序集的成员，你们更新这个成员的分数值。并重新插入这个元素，保证该成员在正确的位置上。  
分数值可以是整数值或双精度浮点数。  
如果有序集合key不存在，则创建一个空的有序集并执行zadd操作。  
如果key存在但不是有序集类型，则返回一个错误。  
注意：在redis2.4版本以前zadd每次只能添加一个元素。  
语法：

zadd score1 value1 ... scoren  valuen

版本：1.2.0  
返回值：被成功添加的新成员数量，不好看那些被更新的、已经存在的成员。  
eg：

127.0.0.1:6379> zadd myzset 1 "hello"
    (integer) 1
    127.0.0.1:6379> zadd myzset 2 "world" 3 "wuzhiming"
    (integer) 2
    127.0.0.1:6379> zrange myzset 0 -1 WITHSCORES
     1) "baidu.com"
     2) "1"
     3) "hello"
     4) "1"
     5) "google.com"
     6) "2"
     7) "world"
     8) "2"
     9) "wuzhiming"
    10) "3"
    127.0.0.1:6379>

**2、zcard命令-获取有序集合的成员数**  
redis中zcard命令用于计算集合中元素的数量。  
语法：

zcard keyname

版本：1.2.0及以上  
返回值：当key存在且是有序集类型时，返回有序集的基数。当key不存在，返回0。  
eg：

127.0.0.1:6379> zrange myzset 0 -1 WITHSCORES
     1) "baidu.com"
     2) "1"
     3) "hello"
     4) "1"
     5) "google.com"
     6) "2"
     7) "world"
     8) "2"
     9) "wuzhiming"
    10) "3"
    127.0.0.1:6379> zcard myzset
    (integer) 5

**3、zcount命令-计算有序集合中指定分数区间的成员数。**  
redis中zcount命令用于计算有序集合中指定分数区间的成员数量  
语法：

zcount key min max

版本：2.0.0及以上  
返回值：分数值在min和max之间的成员的数量。  
eg

127.0.0.1:6379> zrange myzset 0 -1 WITHSCORES
     1) "baidu.com"
     2) "1"
     3) "hello"
     4) "1"
     5) "google.com"
     6) "2"
     7) "world"
     8) "2"
     9) "wuzhiming"
    10) "3"
    127.0.0.1:6379> zcount myzset 1 2
    (integer) 4
    127.0.0.1:6379>

**4、zincrby命令-有序集合中对指定分数加上增量increment**  
redis中zincrby命令对有序集合中指定成员的分数加上增量increment。  
可以通过传递一个负数值increment，让分数减去相应的值。  
当key不存在，或分数不是key的成员时，zincrby key increment member 等同于zadd key member。  
当key不是有序集类型时，返回一个错误。  
分数值科颜氏证书或双精度浮点数。  
语法

zincrby key increment member

版本：1.2.0及以上  
返回值：member成员的新分数值，以字符串形式表示。  
eg

127.0.0.1:6379> zrange myzset 0 -1 WITHSCORES
     1) "baidu.com"
     2) "1"
     3) "hello"
     4) "1"
     5) "google.com"
     6) "2"
     7) "world"
     8) "2"
     9) "wuzhiming"
    10) "3"
    11) "2"
    12) "10"
    127.0.0.1:6379> zincrby myzset 100 baidu.com
    "101"
    127.0.0.1:6379> zrange myzset 0 -1 WITHSCORES
     1) "hello"
     2) "1"
     3) "google.com"
     4) "2"
     5) "world"
     6) "2"
     7) "wuzhiming"
     8) "3"
     9) "2"
    10) "10"
    11) "baidu.com"
    12) "101"
    127.0.0.1:6379>

**5、zinterstore命令-计算给定的一个火啊多个有序集的交集并将结果保存。**  
reids中zinterstore命令计算给定的一个或多个有序的交集，其中给定的key数量必须以numberkeys参数指定，并将该交集（结果集）存储到destination中。  
默认情况下，结果集中某个成员的分数值是所有给定集下改成员分数值之和。  
语法

zinterstore destination numkeys key [WEIGHS weighs ...] [AGGREATE SUM|MIN|MAX]

版本：2.0.0  
返回值：保存到目标结果集的成员数量。  
eg

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

**6、zlexcount命令-在有序集合中计算指定字典区间内的成员数量**  
redis中zlexcount命令在计算有序集合中指定字典区间内成员数量。  
语法

zlexcount key min max

版本：2.8.9  
返回值：指定区间内成员数量  
eg

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

**7、zrange命令-通过索引区间返回有序集合成指定区间内的成员**  
redis中zrange返回有序集中，指定区间内的成员。  
其中成员的位置按分数递增（从小到大）来排序，有相同分数值的成员按照字典序排列。  
下标参数start和stop都以0位底，也就是说，以0表示有序集的第一个元素，-1表示最后一个元素，以此类推。  
语法

zrange key start stop [WITSCORES]

版本：1.2.0及以上  
返回值：指定区间内，带分数值（可选）的有序集成员列表。  
eg

redis 127.0.0.1:6379> ZRANGE salary 0 -1 WITHSCORES             # 显示整个有序集成员
    1) "jack"
    2) "3500"
    3) "tom"
    4) "5000"
    5) "boss"
    6) "10086"
    
    redis 127.0.0.1:6379> ZRANGE salary 1 2 WITHSCORES              # 显示有序集下标区间 1 至 2 的成员
    1) "tom"
    2) "5000"
    3) "boss"
    4) "10086"
    
    redis 127.0.0.1:6379> 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)

**8、zrangebylex命令-通过字典区间返回有序集合的成员**  
redis中zrangebylex通过字典区间返回有序集合的成员。  
语法

zrangebylex key min max [LIMIT offset count]

版本：2.8.9及以上  
返回值：指定区间内的元素列表  
eg

redis 127.0.0.1:6379> ZADD myzset 0 a 0 b 0 c 0 d 0 e 0 f 0 g
    (integer) 7
    redis 127.0.0.1:6379> ZRANGEBYLEX myzset - [c
    1) "a"
    2) "b"
    3) "c"
    redis 127.0.0.1:6379> ZRANGEBYLEX myzset - (c
    1) "a"
    2) "b"
    redis 127.0.0.1:6379> ZRANGEBYLEX myzset [aaa (g
    1) "b"
    2) "c"
    3) "d"
    4) "e"
    5) "f"
    redis>

**9、zrangebyscoe命令-通过分数返回有序集合指定区间内的成员。**  
redis中zrangebyscore返回有序集合中指定分数区间的成员列表，有序集合按照分数递增排列。  
具有相同分数值的成员按字典序来排列，默认情况下，区间的取值使用闭区间。  
语法

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

版本：1.0.5及以上  
返回值：指定区间内，带有分数值（可选）的有序集成员列表  
eg

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

**10、zrank命令-返回有序集合中指定成员的索引**  
redis中zrank命令返回有序集中指定成员的排名，其中有序集成员按分数值递增排序。  
语法

zrank key member

版本：2.0.0  
返回值：如果成员是有序集key的成员，返回member的排名  
eg

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

**11、zrem命令-移除有序集合中的一个或多个成员。**  
redis中zrem命令用于移除有序集中的一个或多个成员。不存在的成员将被忽略。  
当key存在且不是有序集类型是，返回一个错误。  
**注意：在redis2.4版本以前，zrem每次只能删除一个元素。**  
语法

zrank key member1 ... membern

版本：1.2.0  
返回值：被成功移除的成员的数量，不包括被忽略的成员  
eg

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

**11、zremrangebylex命令-移除有序集中给定字典区间的所有成员**  
redis中zremrangebylex命令用于移除有序集合中给定字典区间的所有成员。  
语法

zremrangebylex key min max

版本：2.8.9  
返回值：被成功移除的成员的数量，不看看呗忽略的成员。  
eg

redis 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"
    redis 127.0.0.1:6379> ZREMRANGEBYLEX myzset [alpha [omega
    (integer) 6
    redis 127.0.0.1:6379> ZRANGE myzset 0 -1
    1) "ALPHA"
    2) "aaaa"
    3) "zap"
    4) "zip"
    redis>

**12、zremrangebyrank命令-移除有序集合给定的排名区间的所有成员**  
redis中zremrangebyrank命令用于移除有序集中，指定排名（rank）区间内的所有成员。  
语法

zremrangebyrank key start stop

版本：2.0.0及以上  
返回值：被移除成员的数量  
eg

redis 127.0.0.1:6379> ZADD salary 2000 jack
    (integer) 1
    redis 127.0.0.1:6379> ZADD salary 5000 tom
    (integer) 1
    redis 127.0.0.1:6379> ZADD salary 3500 peter
    (integer) 1
    
    redis 127.0.0.1:6379> ZREMRANGEBYRANK salary 0 1       # 移除下标 0 至 1 区间内的成员
    (integer) 2
    
    redis 127.0.0.1:6379> ZRANGE salary 0 -1 WITHSCORES    # 有序集只剩下一个成员
    1) "tom"
    2) "5000"

**13、zremrangebyscore命令-移除有序集合中给定的分数区间的所有成员**  
redis中zremrangebyscore命令用于移除有序集中，指定分数（score）区间内的所有成员  
语法

zremrangebyscore key min max

版本：1.2.0  
返回值：被移除成员的数量  
eg

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

**14、zrevrank命令-返回有序集合中指定成员的排名，有序集成员按分数递减（从大道小排序）**  
redis中zrevrank命令返回有序集合中指定成员的排名，有序集成员按分数递减（从大道小排序）  
排名以0位底，也就是说，分数值最大的成员排名为0  
使用zrank命令可以获取成员分数值递增的排名  
语法

zrevrank key member

版本：2.2.0  
返回值：如果成员是有序集key的成员，返回成员的排名。如果成员不是有序集合key的成员，返回nil。  
eg

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

**15、zscore命令-返回有序集合中，成员的分数。**  
redis中zscore返回有序集合中，成员的分数。  
语法

zscore key member

版本：1.2.0  
返回值：成员的分数值，以字符串形式表示。  
eg

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

**16、zunionstore命令-计算给定的一个或多个有序集合的并集，并储存**  
redis中zunionstore命令计算给定一个或多个有序集的并集，其中给定key的数量必须由member指定，并将结果集保存到destination。  
默认情况下，结果集中某个成员的分数值是所有给定成员分数值之和。  
语法

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

版本：2.0.0  
返回值：保存到destionation的结果集成员数量  
eg

redis 127.0.0.1:6379> ZRANGE programmer 0 -1 WITHSCORES
    1) "peter"
    2) "2000"
    3) "jack"
    4) "3500"
    5) "tom"
    6) "5000"
    
    redis 127.0.0.1:6379> ZRANGE manager 0 -1 WITHSCORES
    1) "herry"
    2) "2000"
    3) "mary"
    4) "3500"
    5) "bob"
    6) "4000"
    
    redis 127.0.0.1:6379> ZUNIONSTORE salary 2 programmer manager WEIGHTS 1 3   # 公司决定加薪。。。除了程序员。。。
    (integer) 6
    redis 127.0.0.1:6379> ZRANGE salary 0 -1 WITHSCORES
    1) "peter"
    2) "2000"
    3) "jack"
    4) "3500"
    5) "tom"
    6) "5000"
    7) "herry"
    8) "6000"
    9) "mary"
    10) "10500"
    11) "bob"
    12) "12000"

**17、zscan命令-迭代有序集合中的元素（包括元素成员和分数）**  
redis中zscan命令用于迭代有序集合中的元素。  
语法

ZSCAN key cursor [MATCH pattern] [COUNT count]

版本：2.8.0  
返回值：返回的每个元素都是一个有序集合元素，一个有序集合元素有一个成员和分数组成。