Sorted Sets是一组有序、不重复的元素,相比Sets多了score纬度。
ZADD
命令向sorted set中添加元素。
ZADD sset 100 "a" => "(integer) 1"
ZADD sset 200 "b" => "(integer) 1"
ZADD sset 300 "c" 400 "d" => "(integer) 2"
Redis3.0.2开始,ZADD
命令支持一些参数选项:XX
/NX
、CH
、INCR
。
XX
只更新已存在元素,不会新添加。
ZADD sset XX 500 "e" => "(integer) 0"
NX
只添加新元素,不会更新已有元素。
ZADD sset NX 500 "a" => "(integer) 0"
ZADD
命令的返回值代表新增加的元素数量,使用CH
参数,返回值会变为更新元素的数量。更新元素的范围包括新增加的元素与socre发生变化的元素。
INCR
参数用于增加某个元素的score,不能批量使用。
ZADD sset INCR 300 "a" => "400"
Sorted Set允许score相同的元素存在。当多个元素score相同时,会ordered lexicographically(字典排序?字节比较,通过C的memcmp方法)。
ZRANGE
命令按照score从低到高的顺序返回范围内的元素,如果score相同,使用字典排序从低到高。
ZRANGE sset 0 1
=> 1) "b"
=> 2) "c"
ZRANGE sset 0 1 WITHSCORES
=> 1) "b"
=> 2) "200"
=> 3) "c"
=> 4) "300"
ZREVRANGE
命令与ZRANGE
命令使用方式相同,只是返回结果的顺序相反,score从高到低。
ZRANGEBYSCORE
命令返回min<=score<=max范围内的元素。
ZRANGEBYSCORE sset 200 300 WITHSCORES
=> 1) "b"
=> 2) "200"
=> 3) "c"
=> 4) "300"
ZRANGEBYSCORE sset 200 300 WITHSCORES LIMIT 1 1
=> 1) "c"
=> 2) "300"
LIMIT offset count
的用法与sql相似。
可以通过(
控制开闭区间:
ZRANGEBYSCORE sset (200 300 WITHSCORES
=> 1) "c"
=> 2) "300"
ZREVRANGEBYSCORE
命令返回的是ZRANGEBYSCORE
的逆序。
当一个Sorted Set中所有元素score值一样时,ZRANGEBYLEX
命令可以返回字典排序处于范围内的元素。
ZADD myzset 0 a 0 b 0 c 0 d 0 e 0 f 0 g => (integer) 7
ZRANGEBYLEX myzset - [c
=> 1) "a"
=> 2) "b"
=> 3) "c"
ZRANGEBYLEX myzset - (c
=> 1) "a"
=> 2) "b"
ZRANGEBYLEX myzset [aaa (g
=> 1) "b"
=> 2) "c"
=> 3) "d"
=> 4) "e"
=> 5) "f"
(
[
控制开闭区间,使用-
+
区间可以返回所有字符串。ZREVRANGEBYSCORE
命令也可以使用LIMIT offset count
。
ZSCORE
命令返回指定元素的score。
ZADD myzset 1 "one"
=> "(integer) 1"
ZSCORE myzset "one"
=> "1"
ZCARD
命令返回元素总个数。
ZADD myzset 1 "one" => "(integer) 1"
ZADD myzset 2 "two" => "(integer) 1"
ZCARD myzset => "(integer) 2"
ZRANK
命令返回元素在sorted set的位置。ZREVRANK
是ZRANK
逆序的结果。
ZADD myzset 1 "one" => "(integer) 1"
ZADD myzset 2 "two" => "(integer) 1"
ZADD myzset 3 "three" => "(integer) 1"
ZRANK myzset "three" => "(integer) 2"
ZRANK myzset "four" => "(nil)"
ZCOUNT
命令返回指定score区间内的元素个数。
ZADD myzset 1 "one" => "(integer) 1"
ZADD myzset 2 "two" => "(integer) 1"
ZADD myzset 3 "three" => "(integer) 1"
ZCOUNT myzset (1 3 => "(integer) 2"
ZLEXCOUNT
命令返回指定元素区间,按字典排序包含的元素个数。
ZINCRBY
命令增加指定元素的score。
ZADD myzset 1 "one" => "(integer) 1"
ZINCRBY myzset 2 "one" => "3"
ZREM
命令从set中删除指定元素。
ZREM sset "a" "b" => "(integer) 2"
Redis还提供了3种批量删除命令:ZREMRANGEBYLEX
、ZREMRANGEBYRANK
、ZREMRANGEBYSCORE
,分别根据字典排序、RANK、SCORE指定删除区间。
ZINTERSTORE
和ZUNIONSTORE
命令用于计算交集和并集。
ZUNIONSTORE dest 2 set1 set2 WEIGHTS 1 2 AGGREGATE SUM
=> "(integer) 6"
ZUNIONSTORE
命令的结构ZUNIONSTORE destination numkeys key [key ...] [WEIGHTS weight [weight ...]] [AGGREGATE SUM|MIN|MAX]
。
numkeys表示参与计算key的数量。WEIGHTS是权重,权重会影响最终聚合产生的score。AGGREGATE是score的聚合方式,分别是求和、最小、最大。