Redis 的命令详解 - Sorted Set 篇

时间 2019-11-17

标签 redis 命令详解 sorted set 栏目 Redis 繁體版

原文原文链接

相关文章redis

Redis 的命令详解 - Key 篇
 Redis 的命令详解 - String 篇
 Redis 的命令详解 - Hash 篇
 Redis 的命令详解 - List 篇
 Redis 的命令详解 - SET 篇算法

未完待续!!!数组

Sorted Set 命令详解

跟 SET 相关的命令一共有 25 种，这里只介绍经常使用的，其余请参考官网bash

ZADD : 添加成员

起始版本 : 1.2.0
时间复杂度 : O(log(N))，其中N是有序集合中的元素数。架构

向有序集合（sorted set）中，添加分数/成员（score/member）对，能够同时指定多个分数/成员（score/member）对。函数

分数值是一个带符号带双精度浮点型数字字符串。post

若是指定的成员已经在有序集合中，则会更新改为员的分数（scrore）并更新到正确的排序位置。
若是key不存在，将会建立一个新的有序集合（sorted set）并将分数/成员（score/member）对添加到有序集合。

历史

redis 版本 >= 2.4 时，ZADD 命令接受多个成员。在Redis 2.4之前，ZADD 命令只能添加或者更新一个成员。ui

语法

ZADD key [NX|XX] [CH] [INCR] score1 member1 [score2 member2 ...]spa

score 是分数，放在前面 member 是成员code

ZADD 参数

redis 版本 >= Redis 3.0.2时， ZADD支持如下参数

XX : 只更新存在的成员，不添加新成员。
NX : 不更新存在的成员。只添加新成员。
INCR : 当指定这个参数时，成员的操做就等同ZINCRBY命令，对成员的分数进行递增操做，在此模式下只能指定一对分数/成员。
CH : 这个参数有点意思，它的做用是改变返回值！！！
- 没有指定该参数时(默认状况下)，返回的是新添加成员的总数，发生更新的成员不进行计数。
- 指定该参数后，返回的是发生变化的成员总数，即新添加的成员 + 发生更新的成员。(注意，若是一个成员已存在，而且分数也相同，则不会发生更新)

返回值

若是key存在，可是类型不是有序集合，将会返回一个错误应答。
若是指定了，INCR 参数,返回运算后的新分数
若是指定了，CH 参数, 返回的是发生变化的成员总数
同时指定 INCR 和 CH 参数，只要 INCR 生效，返回运算后的新分数
即没有指定 INCR 参数，又没有指定 CH 参数，返回新添加的成员总数

分数能够精确的表示的整数的范围

Redis 有序集合的分数使用双精度64位浮点数。咱们支持全部的架构，这表示为一个IEEE 754 floating point number，它能包括的整数范围是-(2^53) 到 +(2^53)。或者说是-9007199254740992 到 9007199254740992。更大的整数在内部用指数形式表示，因此，若是为分数设置一个很是大的整数，你获得的是一个近似的十进制数。

分数和排序

Sorted Set 按照分数递增的方式进行排序。且不容许存在重复的成员。

分数能够经过ZADD命令进行更新,也能够经过ZINCRBY命令来修改以前的值，分数变化后，对应的成员的排序位置也会随之改变。

获取一个成员当前的分数可使用ZSCORE命令，也能够用它来验证成员是否存在。

相同分数的成员

有序集合里面的成员是不能重复的，可是不一样成员间有可能有相同的分数。当多个成员有相同的分数时，将进行字典排序（ordered lexicographically）。

字典顺序排序用的是二进制，它比较的是字符串的字节数组。

若是用户将全部元素设置相同分数（例如0），有序集合里面的全部元素将按照字典顺序进行排序，范围查询元素可使用ZRANGEBYLEX命令

ZSCORE : 获取成员的分数

起始版本 : 1.2.0
时间复杂度 : O(1)

语法

ZSCORE key member

返回值

成员的分数，成员不存在返回nil

ZREM : 删除成员

起始版本 : 1.2.0
时间复杂度 : O(M*log(N))，其中N是有序集合中的元素数，M是要删除的元素数。

删除指定的成员key，不存在的成员将被忽略。

语法

ZREM key member [member ...]

返回值

删除的成员数，不包括不存在的成员。

历史

reids 版本 >= 2.4时，接受多个 member 参数

ZREMRANGEBYSCORE : 删除给定分数间的全部成员

起始版本 : 1.2.0
时间复杂度 : O(M + log(N))，其中N是有序集合中的元素数，M是要删除的元素数。

删除分数在 min 和之间 max 之间的全部成员，包括min也包括max

语法

ZREMRANGEBYSCORE key min max

返回值

删除的成员

ZREMRANGEBYRANK : 删除指定下标间的全部成员

起始版本 : 2.0.0
时间复杂度 : O(M + log(N))，其中N是有序集合中的元素数，M是要删除的元素数。

删除开始下标和结束下标之间的全部成员，下标从0开始，支持负下标，-1表示最右端成员，包括开始下标也包括结束下标

语法

ZREMRANGEBYSCORE key start stop

返回值

删除的成员

ZINCRBY : 增减成员的分数

起始版本 : 1.2.0
时间复杂度 : O(log(N))，其中N是有序集合中的元素数。

为有序集合中指定成员的分数加上一个带符号的双精度浮点数。

若是 key 不存在，先建立该有序集合
若是指定的成员不存在，先建立该成员，并初始化分数为0

score值必须是字符串表示的整数值或双精度浮点数，而且能接受double精度的浮点数。也有可能给一个负数来减小score的值。

语法

ZINCRBY key 带符号的双精度浮点数 member

返回值

相加后的分数
当key对应的value不是 Sorted Set 类型时，返回一个错误。

ZCARD : 获取集合中成员的个数

起始版本 : 1.2.0
时间复杂度 : O(1)

语法

ZCARD key

返回值

集合中成员的个数，若是key不存在，返回0

ZCOUNT : 获取集合在某个分数范围内的成员个数

起始版本 : 2.0.0
时间复杂度 : O(log(N))，其中N是有序集合中的元素数。

返回有序集合中，分数介于 min 和 max 之间的成员数量。

语法

ZCOUNT key min max

返回值

分数介于 min 和 max 之间的成员数量，若是key不存在，返回0

ZLEXCOUNT : 获取集合在某两个成员之间的成员个数

起始版本 : 2.8.9
时间复杂度 : O(log(N))，其中N是有序集合中的元素数。

返回有序集合中，介于 min 和 max 之间的成员数量。这里的 min 和 max 指的不是分数，而是成员。min 是分数小点的成员，max 是分数大点的成员，若是min成员的分数比max成员的分数还大，返回值为0

因为 Sorted Set 是有序集合(按分数从小到大排序)，因此能够经过成员来搜索

语法

ZLEXCOUNT key min max

返回值

介于 min 和 max 之间的成员数量，若是key不存在，返回0

与 ZCOUNT的区别

ZLEXCOUNT 与 ZCOUNT 语法、做用、返回值都相同，区别在于

ZCOUNT 使用分数来圈定范围
ZLEXCOUNT 使用成员来圈定范围(利用了 Sorted Set 是有序集合的性质)

ZPOPMAX : 删除分数最大成员(右端弹出)

起始版本 : 5.0.0
时间复杂度 : O(log(N) * M)，其中N是排序集中元素的数量，M是弹出元素的数量。

删除并返回有序集合中 count 个分数最高的成员

若是 count 未指定，则默认值为1。
若是 count >= 有序集合中成员的数量，删除并返回(弹出)全部成员

当 count > 1时，分数最高的将是第一个，其次是分数较低的元素。若是分数最高的有多个，按排列循序，从右到左，删除并返回(弹出)。

官方的解释繁琐且不精确，这里说一下个人解释。因为 Sorted Set 是按照分数进行从小到大排序的，分数相同的按照成员的字节数组排序。因此 ZPOPMAX 的做用至关于右端弹出。

语法

ZPOPMAX key [count]

count 表示要弹出的个数

返回值

按照弹出循序的成员/分数对列表

ZPOPMIN : 删除分数最小成员(左端弹出)

起始版本 : 5.0.0
时间复杂度 : O(log(N) * M)，其中N是排序集中元素的数量，M是弹出元素的数量。

左端弹出指定个数的成员/分数对

若是 count 未指定，则默认值为1
若是 count >= 有序集合中成员的数量，删除并返回(弹出)全部成员

语法

ZPOPMIN key [count]

count 表示要弹出的个数

返回值

按照弹出循序的成员/分数对列表

BZPOPMAX : (阻塞式)删除分数最大成员

起始版本 : 5.0.0
时间复杂度 : O(log(N))，其中N为有序集合中元素的数量

BZPOPMAX 是 ZPOPMAX 命令的阻塞版，当有序集合中没有成员时，会阻塞，指定有新成员添加进来或超时。

除此以外，BZPOPMAX 还能够指定多个key，当指定多个key时，按照参数中key的顺序，弹出第一个非空集合中分数最大的成员

语法

BZPOPMAX key1 [key2 ...] timeout

timeout 为超时时间，单位秒。设置为 0 表示无限超时

返回值

key名称、成员名称和分数，超时则返回 nil

BZPOPMIN : (阻塞式)删除分数最小成员

起始版本 : 5.0.0
时间复杂度 : O(log(N))，其中N为有序集合中元素的数量

BZPOPMIN 是 ZPOPMIN 命令的阻塞版，当有序集合中没有成员时，会阻塞，指定有新成员添加进来或超时。

除此以外，BZPOPMIN 还能够指定多个key，当指定多个key时，按照参数中key的顺序，弹出第一个非空集合中分数最小的成员

语法

BZPOPMIN key1 [key2 ...] timeout

timeout 为超时时间，单位秒。设置为 0 表示无限超时

返回值

key名称、成员名称和分数，超时则返回 nil

ZUNIONSTORE : 计算多个集合的并集，并保存

起始版本 : 2.0.0
时间复杂度 : O(N) + O(M log(M))，其中 N 是全部集合的成员数量之和，M 是结果集中元素的数量。

计算指定个数的给定有序集合的并集，并将结果存储在 destination 中。

必须提供 numkeys 参数，而且 numkeys 在 key 及其余可选参数以前

指定 WEIGHTS 参数，能够为每一个有序集合指定一个权重。这意味着，在将每一个有序集合中的成员分数传递给聚合函数以前，都要乘以该权重。若是 WEIGHTS 未指定，则权重默认为1。

指定 AGGREGATE 参数，能够指定如何合并并集的结果。默认使用 SUM 函数。当此选项设置为MIN或时MAX，结果集将选择最小或最大分数的成员。

语法

ZUNIONSTORE destination numkeys key1 [key2 ...] [WEIGHTS weight1 [weight2 ...]] [AGGREGATE SUM | MIN | MAX]

destination : 目标集合，存放运算后的结果集。若是目标集合存在则覆盖。
numkeys : 参与运算的集合数量(key的数量)
WEIGHTS : 为每一个集合指定权重，不指定时全部集合的权重默认为1。redis会将每一个集合中的成员的分数 * 对应集合的权重
AGGREGATE : 汇总算法，默认使用 SUM。
- SUM : 将同一成员的分数相加
- MIN : 取同一成员中分数最小的
- MAX : 取同一成员中分数最大的

返回值

结果集中元素的个数

ZINTERSTORE : 计算多个集合的交集，并保存

起始版本 : 2.0.0
时间复杂度 : O(N) + O(M log(M))，其中 N 是全部集合的成员数量之和，M 是结果集中元素的数量。

计算指定个数的给定有序集合的交集，并将结果存储在 destination 中。

语法

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

destination : 目标集合，存放运算后的结果集。若是目标集合存在则覆盖。
numkeys : 参与运算的集合数量(key的数量)
WEIGHTS : 为每一个集合指定权重，不指定时全部集合的权重默认为1。redis会将每一个集合中的成员的分数 * 对应集合的权重
AGGREGATE : 汇总算法，默认使用 SUM。
- SUM : 将同一成员的分数相加
- MIN : 取同一成员中分数最小的
- MAX : 取同一成员中分数最大的

返回值

结果集中元素的个数

ZRANK : 按分数从小到大获取成员在有序集合中的排名

起始版本 : 2.0.0
时间复杂度 : O(log(N))

按分数从小到大获取成员在有序集合中的排名，排名从0开始(也就是分数最小的排名为0，分数第二小的，排名为1...)

语法

ZRANK key member

返回值

成员对应的排名，若是key或成员不存在，返回nil

例子

redis> ZADD myzset 1 "one"
(integer) 1
redis> ZADD myzset 2 "two"
(integer) 1
redis> ZADD myzset 3 "three"
(integer) 1
redis> ZRANK myzset "three"
(integer) 2
redis> ZRANK myzset "four"
(nil)
redis> 
复制代码

ZREVRANK : 按分数从大到小获取成员在有序集合中的排名

起始版本 : 2.0.0
时间复杂度 : O(log(N))

按分数从大到小获取成员在有序集合中的排名，排名从0开始(也就是分数最大的排名为0，分数第二大的，排名为1...)

语法

ZREVRANK key member

返回值

成员对应的排名，若是key或成员不存在，返回nil

ZRANGE : 范围获取成员并按分数从小到大返回

起始版本 : 1.2.0
时间复杂度 : O(log(N) + M)，N为有序集合中的元素数，M为返回的元素数。

返回开始下标和结束下标内的成员，并按照分数从小到大排序返回。

下标从0开始，支持负下标，-1表示最后一个成员，包括开始下标，也包括结束下标

因为 Sorted Set 是按分数从小到大排序，分数相同按成员字节数组排序，因此下标0表示最左边的成员，下表 -1 表示最右边的成员

下标超出范围不会产生错误。若是开始下标 > 集合最大下标或开始下标 > 结束下标，则结果为一个空列表。

若是结束下标 > 集合最大下标，则将结束下标视为集合的最大下标

语法

ZRANGE key start stop [WITHSCORES]

start : 开始下标
stop : 结束下标
WITHSCORES ：指定此参数时，除了会返回成员外，还会返回成员对应的分数

返回值

指定范围内的成员列表，若是指定了 WITHSCORES 参数，还会包含成员对应的分数。

列表顺序按分数从小到大排序，分数相同按成员字节数组排序

ZREVRANGE : 范围获取成员并按分数从大到小返回

起始版本 : 1.2.0
时间复杂度 : O(log(N) + M)，N为有序集合中的元素数，M为返回的元素数。

返回开始下标和结束下标内的成员，并按照分数从大到小排序返回。

下标从0开始，支持负下标，-1表示最后一个成员，包括开始下标，也包括结束下标

因为 Sorted Set 是按分数从小到大排序，分数相同按成员字节数组排序，因此下标0表示最左边的成员，下表 -1 表示最右边的成员

下标超出范围不会产生错误。若是开始下标 > 集合最大下标或开始下标 > 结束下标，则结果为一个空列表。

若是结束下标 > 集合最大下标，则将结束下标视为集合的最大下标

ZREVRANGE 命令与 ZRANGE 命令惟一的不一样就是返回列表的顺序

语法

ZREVRANGE key start stop [WITHSCORES]

start : 开始下标
stop : 结束下标
WITHSCORES ：指定此参数时，除了会返回成员外，还会返回成员对应的分数

返回值

指定范围内的成员列表，若是指定了 WITHSCORES 参数，还会包含成员对应的分数。

列表顺序按分数从大到小排序，分数相同按成员字节数组排序

ZRANGEBYSCORE : 获取分数范围内的成员并按从小到大返回

起始版本 : 1.0.5
时间复杂度 : O(log(N) + M)，N为有序集合中的元素数，M为返回的元素数。若是M为常数（例如，始终要求使用LIMIT=10），则能够将其视为O(log(N))

返回分数在 min 和 max 之间的成员，包括min 也包括 max

语法

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

min : 小分数
max : 大分数
WITHSCORES : 设置该参数后，除了返回成员外，还会返回成员的对应分数，该参数在 Redis 2.0 开始可用
LIMIT offset count : 分页返回，offset 是结果集中的要返回成员的开始下标，count 是返回的条数，负数表示返回全部

返回值

成员列表，设置 WITHSCORES 参数后，还会返回成员的对应分数

列表顺序按分数从小到大排序，分数相同按成员字节数组排序

ZREVRANGEBYSCORE : 获取分数范围内的成员并按大到小返回

起始版本 : 2.2.0
时间复杂度 : O(log(N) + M)，N为有序集合中的元素数，M为返回的元素数。若是M为常数（例如，始终要求使用LIMIT=10），则能够将其视为O(log(N))

返回分数在 min 和 max 之间的成员，包括min 也包括 max

此命令与 ZRANGEBYSCORE 命令的惟一区别在于，返回结果的排序

ZRANGEBYSCORE 按分数从小到大排序，分数相同按成员字节数组排序
该命令按分数从大到小排序，分数相同按成员字节数组排序

语法

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

max : 大分数
min : 小分数
WITHSCORES : 设置该参数后，除了返回成员外，还会返回成员的对应分数
LIMIT offset count : 分页返回，offset 是结果集中的要返回成员的开始下标，count 是返回的条数，负数表示返回全部

返回值

成员列表，设置 WITHSCORES 参数后，还会返回成员的对应分数

列表顺序按分数从大到小排序，分数相同按成员字节数组排序