redis有序集合数据类型---sortedset

一、概述

  1. redis有序集合和集合一样,也是string类型元素的集合,且不允许重复的成员。
  2. 不同的是每个元素都会关联一个double类型的分数。
  3. redis正式通过分数来为集合中的重圆进行从小到大的排序。
  4. 有序集合的成员是唯一的,但分数(score)却可以重复。
  5. 集合中最大的成员数为2^32-1。

二、sortedset键的设置

  • 命令名称:zadd
  • 语法:zadd key [NX|XX] [CH] [INCR] score member [score member ...]
  • 功能:
    • 将一个或多个member元素及其score值加入到有序集key当中。
    • 如果某个member已经是有序集的成员,那么更新这个member的score值,并通过重新插入这个member元素,来保证该member在正确的位置上。
    • score值可以是整数值或双精度浮点数。
    • 如果key不存在,则创建一个空的有序集并执行zadd操作。
    • 当key存在但不是有序集类型时,返回一个错误。
  • 返回值:
    • 被成功添加的新成员的数量,不包括那些被更新的、已经存在的成员
  • 命令名称:zincrby
  • 语法:zincrby key increment member
  • 功能:
    • 为有序集key的成员member的score值加上增量increment(可负)。
    • 当key不存在,或member不是key的成员时,zincrby等同于zadd
  • 返回值:
    • 当key不是有序集类型时,返回一个错误。member成员的新score值,以字符串形式表示。

三、sortedset键的查询

  • 命令名称:zcard
  • 语法:zcard key
  • 功能:
    • 返回有序集合key的基数(有序集合中元素的数量)
  • 返回值:
    • 当key存在且是有序集类型时,返回有序集的基数。
    • 当key不存在时,返回0
  • 命令名称:zcount
  • 语法:zcount key min max
  • 功能:
    • 返回有序集合key中,score值在min和max之间(默认包括score值等于min或max)的成员的数量。
  • 返回值:
    • score值在min和max之间的成员的数量。
  • 命令名称:zrange
  • 语法:zrange key start stop [withscores]
  • 功能:
    • 返回有序集key中,指定区间内的成员。
    • 其中成员的位置按score值递增(从小到大)来排序。
  • 返回值:
    • 指定区间内,带有score值(可选)的有序集成员的额列表。
  • 命令名称:zrangebyscore
  • 语法:zrangebyscore key min max [withscores] [limit offset count]
  • 功能:
    • 返回有序集key中,所有score值介于min和max之间(包括等于min或max)的成员。有序集成员按score值递增(从小到大)次序排列。
  • 返回值:
    • 指定区间内,带有score值(可选)的有序集成员的列表。
  • 命令名称:zrank
  • 语法:zrank key member
  • 功能:
    • 返回有序集key中成员member的排名。其中有序集成员按score值递增(从小到大)顺序排列。
    • 排名以0为底,也就是说,score值最小的成员排名为0.
  • 返回值:
    • 如果member是有序集key的成员,返回member的排名。
    • 如果member不是有序集key的成员,返回nil。
  • 命令名称:zrevrange
  • 语法:zrevrange key start stop [withscores]
  • 功能:
    • 返回有序集key中,指定区间内的成员。
    • 其中成员的位置按score值递减(从大到小)来排列
  • 返回值:
    • 指定区间内,带有score值(可选)的有序集成员的列表。
  • 命令名称:zrevrangebyscore
  • 语法:zrevrangebyscore key max min [withscores] [limit offset count]
  • 功能:
    • 返回有序集key中,score值介于max和min之间(默认包括等于max或min)的所有成员。有序集成员按score值递减(从大到小)的次序排列。
  • 返回值:
    • 指定区间内,带有score值(可选)的有序集成员的列表。
  • 命令名称:zrevrank
  • 语法:zrevrank key member
  • 功能:
    • 返回有序集key中成员member的排名。其中有序集成员按score值递减顺序排列。
    • 排名以0为底,也就是说,score值最小的成员排名为0.
  • 返回值:
    • 如果member是有序集key的成员,返回member的排名。
    • 如果member不是有序集key的成员,返回nil。
  • 命令名称:zscore
  • 语法:zscore key member
  • 功能:
    • 返回有序集key中成员member的score值。
    • 如果member元素不是有序集key的成员,或key不存在,返回nil。
  • 返回值:
    • member成员的score值,以字符串形式表示。
  • 命令名称:zscan
  • 语法:zscan key cursor [match pattern] [count count]
  • 功能:
    • 用于迭代有序集合键中的元素。
  • 返回值:
    • 有序集合成员。
  • 命令名称:zrangebylex
  • 语法:zrangebylex key min max [limit offset count]
  • 功能:
    • 当有序集合的所有成员都具有相同的分值时,有序集合的元素会根据成员的字典序来进行排序,而这个命令则可以返回给定的有序集合键key中,值介于min和max之间的成员。
  • 返回值:
    • 数组回复:一个列表,列表里面包含了有序集合在指定范围内的成员

  • 命令名称:zlexcount
  • 语法:zlexcount key min max
  • 功能:
    • 对于一个所有成员的分值都相同的有序集合键key来说,这个命令会返回该集合中,成员介于min和max范围内的元素数量。
  • 返回值:
    • 整数回复:指定范围内的元素数量。

四、redis有序集合类型并集和交集处理

  • 命令名称:zunionstore
  • 语法:zunionstore destination numkeys key [key……] [weights weight [weight……]] [aggregate sum|min|max]
  • 功能:
    • 计算给定的一个或多个有序集的并集,其中给定key的数量必须以numkeys参数指定,并将该并集(结果集)存到destinaton。
    • 默认情况下,结果集中某个成员的score值是所有给定集下该成员score值之和。
  • 返回值:
    • 保存到destination的结果集的基数。
  • 命令名称:zinterstore
  • 语法:zinterstore destination numkeys key [key……] [weights weight [weight……]] [aggregate sum|min|max]
  • 功能:
    • 计算给定的一个或多个有序集的交集,其中给定key的数量必须以numkeys参数指定,并将该并集(结果集)存到destinaton。
    • 默认情况下,结果集中某个成员的score值是所有给定集下该成员score值之和。
  • 返回值:
    • 保存到destination的结果集的基数。

五、删除

  • 命令名称:zrem
  • 语法:zrem key member [member……]
  • 功能:
    • 移除有序集key中的一个或多个成员,不存在的成员将被忽略。
    • 当key存在但不是有序集类型时,返回一个错误。
  • 返回值:
    • 被成功移除的成员的数量,不包括别忽略的成员。
  • 命令名称:zremrangebyrank
  • 语法:zremrangebyrank key start stop
  • 功能:
    • 移除有序集key中,指定排名(rank)区间内的所有成员。
    • 区间分别以下标参数start和stop指出,包含start和stop在内。
  • 返回值:
    • 被移除成员的数量。
  • 命令名称:zremrangebyscore
  • 语法:zremrangebyscore key min max
  • 功能:
    • 移除有序集key中,所有score值介于min和max之间(包括等于min或max)的成员。
  • 返回值:
    • 被移除成员的数量。
  • 命令名称:zremrangebylex
  • 语法:zremrangebylex key min max
  • 功能:
    • 对于一个所有成员的分值都相同的有序集合键key来说,这个命令会移除该集合中,成员介于min和max范围内的所有元素。
  • 返回值:
    • 被移除成员的数量。

猜你喜欢

转载自www.cnblogs.com/lxhyty/p/11429904.html