Redis sortedset类型键相关命令整理

小咪咪 2022-02-05 10:57 246阅读 0赞

1.ZADD  
`ZADD key score member [[score member] [score member] ...]`  
向有序集key插入一个或多个member元素及score分值。  
如果member元素已存在key里，则用score更新member元素的分值，并重新插入member元素，使得该元素在有序集中的正确位置上。  
score值可以是整数或双精度浮点数。  
如果key不存在，则创建一个新的有序集key。  
返回被成功添加的新成员的数量，不包括那些被更新的、已经存在的成员。  
如果key不是有序集类型，则返回错误。

2.ZREM  
`ZREM key member [member ...]`  
删除有序集key中一个或多个member元素，不存在的元素则忽略。  
返回被成功移除的成员的数量，不包括被忽略的成员。  
当key不是有序集类型时，返回错误。

3.ZINCRBY  
`ZINCRBY key increment member`  
将有序集key的member元素的分值增加incrememt，increment可以是负数，实现分值的减少。  
当 key 不存在，或 member 不是 key 的成员时，ZINCRBY key increment member 等同于 ZADD key increment member。  
返回member 成员的新 score 值，以字符串形式表示。  
当key不是有序集类型时，返回错误。

4.ZCARD  
`ZCARD key`  
返回有序集key的元素数量。

5.ZCOUNT  
`ZCOUNT key min max`  
返回有序集key中，分值在min和max之间(包括min和max)的元素数量。

6.ZRANGE  
`ZRANGE key start stop [WITHSCORES]`  
成员的位置按 score 值递增 (从小到大) 来排序，返回区间内(start-stop)的元素。  
具有相同 score 值的成员按字典序 (lexicographical order ) 来排列。  
下标参数 start 和 stop 都以 0 为底，也就是说，以 0 表示有序集第一个成员，以 1 表示有序集第二个成员，以此类推。  
你也可以使用负数下标，以 -1 表示最后一个成员，-2 表示倒数第二个成员，以此类推。  
可以通过使用 WITHSCORES 选项，来让成员和它的 score 值一并返回。

7.ZRANGEBYSCORE  
`ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT offset count]`  
有序集成员按score 值递增 (从小到大) 次序排列，返回排名在min和max之间(包括)的元素，具有相同 score 值的成员按字典序 (lexicographical order) 来排列。  
可以通过使用 WITHSCORES 选项，来让成员和它的 score 值一并返回。  
LIMIT 参数指定返回结果的数量及区间。  
默认情况下，区间的取值使用闭区间 (小于等于或大于等于)，你也可以通过给参数前增加 ( 符号来使用可选的开区间 (小于或大于)。

8.ZRANK  
`ZRANK key member`  
有序集成员按 score 值递增 (从小到大) 顺序排列，返回有序集 key 中成员 member 的排名。  
排名以 0 为底，也就是说，score 值最小的成员排名为0。  
如果 member 不是有序集 key 的成员，返回 nil。

9.ZREMRANGEBYRANK  
`ZREMRANGEBYRANK key start stop`  
移除有序集 key 中，指定排名 (rank) 区间内(包括)的所有成员。

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

11.ZREVRANGE  
`ZREVRANGE key start stop [WITHSCORES]`  
中成员的位置按 score 值递减 (从大到小) 来排列，返回有序集 key 中，指定区间内的成员。

12.ZREVRANGEBYSCORE  
`ZREVRANGEBYSCORE key max min [WITHSCORES] [LIMIT offset count]`  
返回有序集 key 中，score 值介于 max 和 min 之间 (默认包括等于 max 或 min ) 的所有的成员。有序集成员按 score 值递减 (从大到小) 的次序排列。  
具有相同 score 值的成员按字典序的逆序 (reverse lexicographical order ) 排列。

13.ZREVRANK  
`ZREVRANK key member`  
返回有序集 key 中成员 member 的排名。其中有序集成员按 score 值递减 (从大到小) 排序。  
排名以 0 为底，也就是说，score 值最大的成员排名为 0 。

14.SCORE  
`ZSCORE key member`  
返回有序集 key 中，成员 member 的 score 值。  
如果 member 元素不是有序集 key 的成员，或 key 不存在，返回 nil。

15.ZUNIONSTORE  
`ZUNIONSTORE destination numkeys key [key ...] [WEIGHTS weight [weight ...]] [AGGREGATE SUM|MIN|MAX]`  
计算给定的一个或多个有序集的并集，其中给定 key 的数量必须以 numkeys 参数指定，并将该并集 (结果集) 储存到 destination 。  
默认情况下，结果集中某个成员的 score 值是所有给定集下该成员 score 值之 和 。  
WEIGHTS  
使用 WEIGHTS 选项，你可以为 每个 给定有序集 分别 指定一个乘法因子 (multiplication factor)，每个给定有序集的所有成员的 score 值在传递给聚合函数 (aggregation function) 之前都要先乘以该有序集的因子。  
如果没有指定 WEIGHTS 选项，乘法因子默认设置为 1 。  
AGGREGATE  
使用 AGGREGATE 选项，你可以指定并集的结果集的聚合方式。  
默认使用的参数 SUM ，可以将所有集合中某个成员的 score 值之 和 作为结果集中该成员的 score 值；使用参数 MIN ，可以将所有集合中某个成员的 最小 score 值作为结果集中该成员的 score 值；而参数 MAX则是将所有集合中某个成员的 最大 score 值作为结果集中该成员的 score 值。

16.ZINTERSTORE  
`ZINTERSTORE destination numkeys key [key ...] [WEIGHTS weight [weight ...]] [AGGREGATE SUM|MIN|MAX]`  
计算给定的一个或多个有序集的交集，其中给定 key 的数量必须以 numkeys 参数指定，并将该交集 (结果集) 储存到 destination 。  
默认情况下，结果集中某个成员的 score 值是所有给定集下该成员 score 值之和。