redis 有序集合zset命令

怼烎@ 2022-12-21 03:15 485阅读 0赞

备注:测试版本 redis 4.0.9

### 文章目录 ###

*  有序集合(sorted set)命令概述
 *   *  1.1 ZADD命令
     *  1.2 ZCARD命令
     *  1.3 ZCOUNT命令
     *  1.4 ZINCRBY命令
     *  1.5 ZINTERSTORE命令
     *  1.6 ZLEXCOUNT命令
     *  1.7 ZRANGE命令
     *  1.8 ZRANGEBYLEX命令
     *  1.9 ZRANGEBYSCORE命令
     *  1.10 ZRANK命令
     *  1.11 ZREM命令
     *  1.12 ZREMRANGEBYLEX命令
     *  1.13 ZREMRANGEBYRANK命令
     *  1.14 ZREMRANGEBYSCORE命令
     *  1.15 ZREVRANGE命令
     *  1.16 ZREVRANGEBYSCORE命令
     *  1.17 ZREVRANK命令
     *  1.18 ZSCORE命令
     *  1.19 ZUNIONSTORE命令
     *  1.20 ZSCAN命令
 *  参考

# 有序集合(sorted set)命令概述 #

Redis 有序集合和集合一样也是string类型元素的集合,且不允许重复的成员。

不同的是每个元素都会关联一个double类型的分数。redis正是通过分数来为集合中的成员进行从小到大的排序。

有序集合的成员是唯一的,但分数(score)却可以重复。

集合是通过哈希表实现的，所以添加，删除，查找的复杂度都是O(1)。 集合中最大的成员数为 232 - 1 (4294967295, 每个集合可存储40多亿个成员)。

<table> 
 <thead> 
  <tr> 
   <th>命令</th> 
   <th>概述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>ZADD</td> 
   <td>向有序集合添加一个或多个成员，或者更新已存在成员的分数</td> 
  </tr> 
  <tr> 
   <td>ZCARD</td> 
   <td>获取有序集合的成员数</td> 
  </tr> 
  <tr> 
   <td>ZCOUNT</td> 
   <td>计算在有序集合中指定区间分数的成员数</td> 
  </tr> 
  <tr> 
   <td>ZINCRBY</td> 
   <td>有序集合中对指定成员的分数加上增量</td> 
  </tr> 
  <tr> 
   <td>ZINTERSTORE</td> 
   <td>计算给定的一个或多个有序集的交集并将结果集存储在新的有序集合 key 中</td> 
  </tr> 
  <tr> 
   <td>ZLEXCOUNT</td> 
   <td>在有序集合中计算指定字典区间内成员数量</td> 
  </tr> 
  <tr> 
   <td>ZRANGE</td> 
   <td>通过索引区间返回有序集合成指定区间内的成员</td> 
  </tr> 
  <tr> 
   <td>ZRANGEBYLEX</td> 
   <td>通过字典区间返回有序集合的成员</td> 
  </tr> 
  <tr> 
   <td>ZRANGEBYSCORE</td> 
   <td>通过分数返回有序集合指定区间内的成员</td> 
  </tr> 
  <tr> 
   <td>ZRANK</td> 
   <td>返回有序集合中指定成员的索引</td> 
  </tr> 
  <tr> 
   <td>ZREM</td> 
   <td>移除有序集合中的一个或多个成员</td> 
  </tr> 
  <tr> 
   <td>ZREMRANGEBYLEX</td> 
   <td>移除有序集合中给定的字典区间的所有成员</td> 
  </tr> 
  <tr> 
   <td>ZREMRANGEBYRANK</td> 
   <td>移除有序集合中给定的排名区间的所有成员</td> 
  </tr> 
  <tr> 
   <td>ZREMRANGEBYSCORE</td> 
   <td>移除有序集合中给定的分数区间的所有成员</td> 
  </tr> 
  <tr> 
   <td>ZREVRANGE</td> 
   <td>返回有序集中指定区间内的成员，通过索引，分数从高到底</td> 
  </tr> 
  <tr> 
   <td>ZREVRANGEBYSCORE</td> 
   <td>返回有序集中指定分数区间内的成员，分数从高到低排序</td> 
  </tr> 
  <tr> 
   <td>ZREVRANK</td> 
   <td>返回有序集合中指定成员的排名，有序集成员按分数值递减(从大到小)排序</td> 
  </tr> 
  <tr> 
   <td>ZSCORE</td> 
   <td>返回有序集中，成员的分数值</td> 
  </tr> 
  <tr> 
   <td>ZUNIONSTORE</td> 
   <td>计算给定的一个或多个有序集的并集，并存储在新的 key 中</td> 
  </tr> 
  <tr> 
   <td>ZSCAN</td> 
   <td>迭代有序集合中的元素（包括元素成员和元素分值）</td> 
  </tr> 
 </tbody> 
</table>

## 1.1 ZADD命令 ##

语法:

ZADD key score1 member1 [score2 member2] 向有序集合添加一个或多个成员，或者更新已存在成员的分数

测试记录

127.0.0.1:6379> zadd my_db 1 Oracle
    (integer) 1
    127.0.0.1:6379> zadd my_db 1 MySQL
    (integer) 1
    127.0.0.1:6379> zadd my_db 2 Redis
    (integer) 1
    127.0.0.1:6379> zadd my_db 2 Memcache
    (integer) 1
    127.0.0.1:6379> 
    127.0.0.1:6379> zrange my_db 0 -1 withscores
    1) "MySQL"
    2) "1"
    3) "Oracle"
    4) "1"
    5) "Memcache"
    6) "2"
    7) "Redis"
    8) "2"
    127.0.0.1:6379>

## 1.2 ZCARD命令 ##

语法:

ZCARD key 获取有序集合的成员数

测试记录

## 1.3 ZCOUNT命令 ##

语法:

ZCOUNT key min max 计算在有序集合中指定区间分数的成员数

测试记录

del key my_db
    127.0.0.1:6379> zadd my_db 1 Oracle
    (integer) 1
    127.0.0.1:6379> zadd my_db 1 MySQL
    (integer) 1
    127.0.0.1:6379> zadd my_db 2 Redis
    (integer) 1
    127.0.0.1:6379> zadd my_db 2 Memcache
    (integer) 1
    127.0.0.1:6379> zcount my_db 1 3
    (integer) 4
    127.0.0.1:6379> zcount my_db 1 1
    (integer) 2
    127.0.0.1:6379>

## 1.4 ZINCRBY命令 ##

语法:

ZINCRBY key increment member 有序集合中对指定成员的分数加上增量 increment

测试记录

del key my_db
    127.0.0.1:6379> zadd my_db 1 Oracle
    (integer) 1
    127.0.0.1:6379> zadd my_db 1 MySQL
    (integer) 1
    127.0.0.1:6379> zadd my_db 2 Redis
    (integer) 1
    127.0.0.1:6379> zadd my_db 2 Memcache
    (integer) 1
    127.0.0.1:6379> zincrby my_db 1 Oracle
    "2"
    127.0.0.1:6379> zrange my_db 0 -1 withscores
    1) "MySQL"
    2) "1"
    3) "Memcache"
    4) "2"
    5) "Oracle"
    6) "2"
    7) "Redis"
    8) "2"
    127.0.0.1:6379>

## 1.5 ZINTERSTORE命令 ##

语法:

ZINTERSTORE destination numkeys key [key ...] 计算给定的一个或多个有序集的交集并将结果集存储在新的有序集合 key 中

测试记录

127.0.0.1:6379> del key my_db
    (integer) 1
    127.0.0.1:6379> del key my_db2
    (integer) 0
    127.0.0.1:6379> zadd my_db 1 Oracle
    (integer) 1
    127.0.0.1:6379> zadd my_db 1 MySQL
    (integer) 1
    127.0.0.1:6379> zadd my_db 2 Redis
    (integer) 1
    127.0.0.1:6379> zadd my_db 2 MongoDB
    (integer) 1
    127.0.0.1:6379> zadd my_db2 100 Oracle
    (integer) 1
    127.0.0.1:6379> zadd my_db2 100 Redis
    (integer) 1
    127.0.0.1:6379> zinterstore sum_db 2 my_db my_db2
    (integer) 2
    127.0.0.1:6379> zrange sum_db 0 -1 withscores
    1) "Oracle"
    2) "101"
    3) "Redis"
    4) "102"
    127.0.0.1:6379>

## 1.6 ZLEXCOUNT命令 ##

语法:

ZLEXCOUNT key min max 在有序集合中计算指定字典区间内成员数量

测试记录

127.0.0.1:6379> del key my_db
    (integer) 1
    127.0.0.1:6379> zadd my_db 1 Oracle
    (integer) 1
    127.0.0.1:6379> zadd my_db 1 MySQL
    (integer) 1
    127.0.0.1:6379> zadd my_db 2 Redis
    (integer) 1
    127.0.0.1:6379> zadd my_db 2 MongoDB
    (integer) 1
    127.0.0.1:6379> zlexcount my_db - +
    (integer) 4
    127.0.0.1:6379> zlexcount my_db [A [F
    (integer) 0
    127.0.0.1:6379>

## 1.7 ZRANGE命令 ##

语法:

ZRANGE key start stop [WITHSCORES] 通过索引区间返回有序集合成指定区间内的成员

测试记录

## 1.8 ZRANGEBYLEX命令 ##

语法:

ZRANGEBYLEX key min max [LIMIT offset count] 通过字典区间返回有序集合的成员

测试记录

127.0.0.1:6379> del key my_db
    (integer) 1
    127.0.0.1:6379> del key my_db2
    (integer) 0
    127.0.0.1:6379> zadd my_db 1 Oracle
    (integer) 1
    127.0.0.1:6379> zadd my_db 1 MySQL
    (integer) 1
    127.0.0.1:6379> zadd my_db 2 Redis
    (integer) 1
    127.0.0.1:6379> zadd my_db 2 MongoDB
    (integer) 1
    127.0.0.1:6379> zrangebylex my_db - +
    1) "MySQL"
    2) "Oracle"
    3) "MongoDB"
    4) "Redis"
    127.0.0.1:6379> zrangebylex my_db - (O
    1) "MySQL"
    127.0.0.1:6379> zrangebylex my_db - (M
    (empty list or set)
    127.0.0.1:6379>

## 1.9 ZRANGEBYSCORE命令 ##

语法:

ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT] 通过分数返回有序集合指定区间内的成员

测试记录

127.0.0.1:6379> del key my_db
    (integer) 1
    127.0.0.1:6379> del key my_db2
    (integer) 0
    127.0.0.1:6379> zadd my_db 1 Oracle
    (integer) 1
    127.0.0.1:6379> zadd my_db 1 MySQL
    (integer) 1
    127.0.0.1:6379> zadd my_db 2 Redis
    (integer) 1
    127.0.0.1:6379> zadd my_db 2 MongoDB
    (integer) 1
    127.0.0.1:6379> zrangebyscore my_db 0 1
    1) "MySQL"
    2) "Oracle"
    127.0.0.1:6379> 
    127.0.0.1:6379> 
    127.0.0.1:6379> zrangebyscore my_db 0 1 withscores
    1) "MySQL"
    2) "1"
    3) "Oracle"
    4) "1"
    127.0.0.1:6379> zrangebyscore my_db 0 2 withscores
    1) "MySQL"
    2) "1"
    3) "Oracle"
    4) "1"
    5) "MongoDB"
    6) "2"
    7) "Redis"
    8) "2"
    127.0.0.1:6379>

## 1.10 ZRANK命令 ##

语法:

ZRANK key member 返回有序集合中指定成员的索引

测试记录

## 1.11 ZREM命令 ##

语法:

ZREM key member [member ...] 移除有序集合中的一个或多个成员

测试记录

127.0.0.1:6379> del key my_db
    (integer) 1
    127.0.0.1:6379> del key my_db2
    (integer) 0
    127.0.0.1:6379> zadd my_db 1 Oracle
    (integer) 1
    127.0.0.1:6379> zadd my_db 1 MySQL
    (integer) 1
    127.0.0.1:6379> zadd my_db 2 Redis
    (integer) 1
    127.0.0.1:6379> zadd my_db 2 MongoDB
    (integer) 1
    127.0.0.1:6379> del key my_db
    (integer) 1
    127.0.0.1:6379> del key my_db2
    (integer) 0
    127.0.0.1:6379> zadd my_db 1 Oracle
    (integer) 1
    127.0.0.1:6379> zadd my_db 1 MySQL
    (integer) 1
    127.0.0.1:6379> zadd my_db 2 Redis
    (integer) 1
    127.0.0.1:6379> zadd my_db 2 MongoDB
    (integer) 1

## 1.12 ZREMRANGEBYLEX命令 ##

语法:

ZREMRANGEBYLEX key min max 移除有序集合中给定的字典区间的所有成员

测试记录

127.0.0.1:6379> del key my_db
    (integer) 1
    127.0.0.1:6379> del key my_db2
    (integer) 0
    127.0.0.1:6379> zadd my_db 1 Oracle
    (integer) 1
    127.0.0.1:6379> zadd my_db 1 MySQL
    (integer) 1
    127.0.0.1:6379> zadd my_db 2 Redis
    (integer) 1
    127.0.0.1:6379> zadd my_db 2 MongoDB
    (integer) 1
    127.0.0.1:6379> zrange my_db 0 -1 withscores
    1) "MySQL"
    2) "1"
    3) "Oracle"
    4) "1"
    5) "MongoDB"
    6) "2"
    7) "Redis"
    8) "2"
    127.0.0.1:6379> zremrangebylex my_db [A [Z
    (integer) 4
    127.0.0.1:6379> zrange my_db 0 -1 withscores
    (empty list or set)
    127.0.0.1:6379>

## 1.13 ZREMRANGEBYRANK命令 ##

语法:

ZREMRANGEBYRANK key start stop 移除有序集合中给定的排名区间的所有成员

测试记录

127.0.0.1:6379> del key my_db
    (integer) 0
    127.0.0.1:6379> 
    127.0.0.1:6379> zadd my_db 1 Oracle 1 MySQL 2 Redis 2 MOngoDB
    (integer) 4
    127.0.0.1:6379> 
    127.0.0.1:6379> zrange my_db 0 -1 withscores
    1) "MySQL"
    2) "1"
    3) "Oracle"
    4) "1"
    5) "MOngoDB"
    6) "2"
    7) "Redis"
    8) "2"
    127.0.0.1:6379> zremrangebyrank my_db 0 1
    (integer) 2
    127.0.0.1:6379> zrange my_db 0 -1 withscores
    1) "MOngoDB"
    2) "2"
    3) "Redis"
    4) "2"
    127.0.0.1:6379>

## 1.14 ZREMRANGEBYSCORE命令 ##

语法:

ZREMRANGEBYSCORE key min max 移除有序集合中给定的分数区间的所有成员

测试记录

127.0.0.1:6379> del key my_db
    (integer) 1
    127.0.0.1:6379> zadd my_db 1 Oracle 1 MySQL 2 Redis 2 MOngoDB
    (integer) 4
    127.0.0.1:6379> 
    127.0.0.1:6379> 
    127.0.0.1:6379> 
    127.0.0.1:6379> 
    127.0.0.1:6379> zrange my_db 0 -1 withscores
    1) "MySQL"
    2) "1"
    3) "Oracle"
    4) "1"
    5) "MOngoDB"
    6) "2"
    7) "Redis"
    8) "2"
    127.0.0.1:6379> zremrangebyscore my_db 0 1
    (integer) 2
    127.0.0.1:6379> zrange my_db 0 -1 withscores
    1) "MOngoDB"
    2) "2"
    3) "Redis"
    4) "2"
    127.0.0.1:6379>

## 1.15 ZREVRANGE命令 ##

语法:

ZREVRANGE key start stop [WITHSCORES] 返回有序集中指定区间内的成员，通过索引，分数从高到底

## 1.16 ZREVRANGEBYSCORE命令 ##

语法:

ZREVRANGEBYSCORE key max min [WITHSCORES] 返回有序集中指定分数区间内的成员，分数从高到低排序

测试记录

127.0.0.1:6379> del key my_db
    (integer) 1
    127.0.0.1:6379> zadd my_db 1 Oracle 1 MySQL 2 Redis 2 MOngoDB
    (integer) 4
    127.0.0.1:6379> zrevrange my_db 0 -1 withscores
    1) "Redis"
    2) "2"
    3) "MOngoDB"
    4) "2"
    5) "Oracle"
    6) "1"
    7) "MySQL"
    8) "1"
    127.0.0.1:6379>

## 1.17 ZREVRANK命令 ##

语法:

ZREVRANK key member 返回有序集合中指定成员的排名，有序集成员按分数值递减(从大到小)排序

测试记录

127.0.0.1:6379> del key my_db
    (integer) 1
    127.0.0.1:6379> zadd my_db 1 Oracle 1 MySQL 2 Redis 2 MOngoDB
    (integer) 4
    127.0.0.1:6379> ZREVRANK my_db Oracle
    (integer) 2
    127.0.0.1:6379> ZREVRANK my_db MySQL
    (integer) 3
    127.0.0.1:6379> ZREVRANK my_db Redis
    (integer) 0
    127.0.0.1:6379> ZREVRANK my_db Mongodb
    (nil)
    127.0.0.1:6379>

## 1.18 ZSCORE命令 ##

语法:

ZSCORE key member 返回有序集中，成员的分数值

测试记录

## 1.19 ZUNIONSTORE命令 ##

语法:

ZUNIONSTORE destination numkeys key [key ...] 计算给定的一个或多个有序集的并集，并存储在新的 key 中

测试记录

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

## 1.20 ZSCAN命令 ##

语法:

ZSCAN key cursor [MATCH pattern] [COUNT count] 迭代有序集合中的元素（包括元素成员和元素分值）

# 参考 #

1.[https://www.redis.net.cn/tutorial/3505.html][https_www.redis.net.cn_tutorial_3505.html]

[https_www.redis.net.cn_tutorial_3505.html]: https://www.redis.net.cn/tutorial/3505.html