1. 介绍
Sorted Set是字符串的集合,不允许重复的成员出现在一个Set中。Sorted Set是有序集合,在Sorted Sett内部的每一个元素,都有一个score与value关联。Sort Set的有序性就是通过score保证的。Sorted Set属于Set,具有Set的全部特性,同时Sorted Set拥有Set的额外的一个特性Sort。尽管Set的value不允许重复,但是score却是允许重复的。
在Set中增加、删除、更新元素是一个资源消耗非常小的操作。因为Sorted Set是有序的,所以即使访问Set的中部的元素,依然具有很高的效率。这是Redis的优势,其他数据库中想要实现这一点,比较困难。
2. 命令
2.1 增加
命令:==ZADD key score element [score element ....]==
命令说明:增加Sorted Set元素,如果key不存在,那么会创建key,如果element不存在,那么会将element加入key的Sorted Set.如果element已经在key对应的Sorted Set中了,那么就更新element的score,更新了score,就会进行重新排序。如果key对应的不是Sorted Set,那么执行异常。
返回值:实际增加的element数量。0:element本来就存在,本次只是进行了更新score。
2.2 统计个数
命令:==ZCARD key==
命令说明:获取key对应的Sorted Set的element数量。
返回值:返回key对应的Sorted Set的元素数量。0:key不存在或者Sorted Set为空。
2.3 统计指定分数范围的元素个数
命令:==ZCOUNTT key [(]min [(]max==
命令说明:统计key对应的Sorted Set中元素的score在min和max范围内的元素数量。==min表示闭区间,(min表示开区间;max表示闭区间,(max表示开区间。开闭区间可以自由搭配。==如果key对应的不是Sorted Set,执行异常。
返回值:指定key对应的Sorted Set的元素的score在指定区间内的元素数量。0:key不存在或者score区间内的元素为空。
2.4 获取分数
命令:==ZSCORE key element==
命令说明:获取指定key的Sorted Set的指定element的score。如果key对应的不是Sorted Set,执行异常。
返回值:字符串形式的分数。空:key不存在,或者element不存在。
2.5 增加分数
命令:==ZINCRBY key increment element==
命令说明:指定的key的Sorted Set的指定的element的score更新为score+increment。如果key不存在,则创建key对应的Sorted Set。如果指定key对应的Sorted Set中不存在element则,新增element,并且设置原score为0,然后将0+increment设置为新的score。如果key对应的不是Sorted Set,执行异常。
返回值:更新后的分数,以字符串形式。
2.6 获取指定范围的元素(score从小到大)
命令:==ZRANGE key start end [WITHSCORES]==
命令说明:获取指定key对应的Sorted Set在start到end(index)范围内的元素(score从小到大)。==如果有[WITHSCORES]那么返回元素的时候会将score一起返回。==start:0,第一个元素;-1,最后一个元素。如果start > end返回空列表;如果end > length返回start之后的全部元素。如果key对应的不是Sorted Set,执行异常。
返回值:元素列表。一个元素,一个分数,交替返回。
2.7 获取指定范围的元素(score从大到小)
命令:==ZREVRANGE key start end [WITHSCORES]==
命令说明:获取指定key对应的Sorted Set在start到end(index)范围内的元素(score从大到小)。==如果有[WITHSCORES]那么返回元素的时候会将score一起返回。==start:0,第一个元素;-1,最后一个元素。如果start > end返回空列表;如果end > length返回start之后的全部元素。如果key对应的不是Sorted Set,执行异常。
返回值:元素列表。一个元素,一个分数,交替返回。
2.8 获取指定分数范围的元素(score从小到大)
命令:==ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT offset count]==
命令说明:获取指定key的Sorted Set中score在min和max的闭区间内的元素(score从小到大)。WITHSCORES一起返回元素和分数,交替返回。LIMIT offset count表示从满足条件列表的第offset开始返回,返回count个。min和max可以使用==(==来使用开区间。==如果分数相同,则按照字典顺序返回。==
返回值:元素列表。一个元素,一个分数,交替返回。
2.9 获取指定分数范围的元素(score从大到小)
命令:==ZREVRANGEBYSCORE key max min [WITHSCORES] [LIMIT offset count]==
命令说明:获取指定key的Sorted Set中score在min和max的闭区间内的元素(score从大到小)。WITHSCORES一起返回元素和分数,交替返回。LIMIT offset count表示从满足条件列表的第offset开始返回,返回count个。min和max可以使用==(==来使用开区间。==如果分数相同,则按照字典顺序返回。==
返回值:元素列表。一个元素,一个分数,交替返回。
2.10 获取元素的索引(score从小到大)
命令:==ZRANK key element==
命令说明:在Sorted Set中的元素都是按照score从小到大的顺序排序,如果score相同则按照字典顺序排序。获取到指定key对应的Sorted Set的element的index值。
返回值:0:第一个元素的索引;非0:元素的索引值;空:元素或者key不存在。
2.11 获取元素的索引(score从大到小)
命令:==ZREVRANK key element==
命令说明:在Sorted Set中的元素都是按照score从大到小的顺序排序,如果score相同则按照字典顺序排序。获取到指定key对应的Sorted Set的element的index值。
返回值:0:第一个元素的索引;非0:元素的索引值;空:元素或者key不存在。
2.12 删除
命令:==ZREM key element [element ...]==
命令说明:删除指定key对应的Sorted Set中指定的lelement的元素。如果元素或者key不存在,则什么都不做。如果key对应的不是Sorted Set,执行异常。
返回值:实际被删除的element的数量。
2.13 根据索引范围删除
命令:==ZREMRANGEBYRANK key start end==
命令说明:删除指定key对应的Sorted Set中索引在start和end区间内的元素。start为0表示第一个索引,为-1表示最后一个索引。如果key对应的不是Sorted Set,执行异常。
返回值:实际被删除的element的数量。
2.14 根据分数范围删除
命令:==ZREMRANGEBYSCORE** key min max==
命令说明:删除指定key对应的Sorted Set中分数在min和max闭区间内的元素。可以使用==(==使用开区间。如果key对应的不是Sorted Set,执行异常。
返回值:实际被删除的element的数量。
3. 示例
3.1 排行榜
我们经常可以看到在一些比赛中,会展示排行榜的前x名。
首先创建一个Sorted Set,然后我们将name和score存入。最后获取的时候按照index或者score范围查询即可。
==获取前5名==
==获取分数排名前5==
3.2 排行榜--分页
假设我们的排行榜上面不仅仅有分数,还有参赛者的介绍等等。
所以:
冠军:一页展示
亚军,季军:一页展示
第4~10名:一页展示
第20~50名:一页展示
3.3 排行榜查询
如果排行榜比较多的时候,玩家需要查询自己在排行榜中的位置。
3.4 定期清理超时数据
将数据的超时时间设置为分数,定期清理到时间的数据。