Redis笔记7：数据类型之有序集合(sorted set)

命令                    描述                                            例子
ZADD                添加排序成员                           ZADD key score member [score] [member]
ZCARD               获取成员数量                           ZCARD key
ZCOUNT              获取分数在min和max之间成员有多少个       ZCOUNT key min max
ZINCRBY             增加指定成员的分数                      ZINCRBY key increment member
ZRANGE              遍历成员以及分数                        ZRANGE key start stop [WITHSCORES]
ZRANGEBYSCORE       返回分数在min和max之间的成员和分数       ZRANGEBYSCORE key min max [WITHSCORES]
ZRANK               返回成员的下标                          ZRANK key member
ZREM                删除指定成员                            ZREM key member [member ...]
ZREVRANGE           遍历成员以及分数从大到小                 ZREVRANGE key start stop [WITHSCORES]
ZREVRANK            返回成员下标顺序从大到小                 ZREVRANK key member
ZSCORE              获取指定成员的分数                      ZSCORE key member
ZREVRANGEBYSCORE    获取成员以及分数按照从高到低             ZREVRANGEBYSCORE key max min [WITHSCORES]
ZREMRANGEBYRANK     删除下标之间的数据                      ZREMRANGEBYRANK key start stop
ZREMRANGEBYSCORE    删除分数在min和max中的成员              ZREMRANGEBYSCORE key min max

1、ZADD key score member [[score member] [score member] …]

将一个或多个 member 元素及其 score 值加入到有序集 key 当中。 如果某个 member 已经是有序集的成员，那么更新这个 member 的 score 值，并通过重新插入这个 member元素，来保证该 member 在正确的位置上。 score 值可以是整数值或双精度浮点数。 如果 key 不存在，则创建一个空的有序集并执行ZADD 操作。 当 key 存在但不是有序集类型时，返回一个错误。

返回值: 被成功添加的新成员的数量，不包括那些被更新的、已经存在的成员。

示例：

127.0.0.1:6379[15]> ZADD page_rank 10 google.com            # 添加单个元素
(integer) 1

127.0.0.1:6379[15]> ZADD page_rank 9 baidu.com 8 bing.com   # 添加多个元素
(integer) 2
127.0.0.1:6379[15]> ZRANGE page_rank 0 -1 WITHSCORES
1) "bing.com"
2) "8"
3) "baidu.com"
4) "9"
5) "google.com"
6) "10"

127.0.0.1:6379[15]> ZADD page_rank 10 google.com            # 添加已存在元素
(integer) 0
127.0.0.1:6379[15]> ZRANGE page_rank 0 -1 WITHSCORES
1) "bing.com"
2) "8"
3) "baidu.com"
4) "9"
5) "google.com"
6) "10"

127.0.0.1:6379[15]> ZADD page_rank 6 bing.com               # 添加已存在元素，但是改变 score 值
(integer) 0
127.0.0.1:6379[15]> ZRANGE page_rank 0 -1 WITHSCORES
1) "bing.com"
2) "6"
3) "baidu.com"
4) "9"
5) "google.com"
6) "10"

2、ZCARD key

返回有序集 key 的基数。

返回值: 当 key 存在且是有序集类型时，返回有序集的基数。 当 key 不存在时，返回 0 。

示例：

127.0.0.1:6379[15]> ZADD salary 2000 tom
(integer) 1
127.0.0.1:6379[15]> ZCARD salary
(integer) 1
127.0.0.1:6379[15]> ZADD salary 5000 jack
(integer) 1
127.0.0.1:6379[15]> ZCARD salary
(integer) 2
127.0.0.1:6379[15]> EXISTS non_exists_key
(integer) 0
127.0.0.1:6379[15]> ZCARD non_exists_key
(integer) 0

3、ZCOUNT key min max

返回有序集 key 中，score 值在 min 和 max 之间 (默认包括 score 值等于 min 或 max ) 的成员的数量。

**返回值: **score 值在 min 和 max 之间的成员的数量。

示例：

127.0.0.1:6379[15]> ZADD salary 2000 tom 3500 peter 5000 jack
(integer) 2
127.0.0.1:6379[15]> ZRANGE salary 0 -1 WITHSCORES
1) "tom"
2) "2000"
3) "peter"
4) "3500"
5) "jack"
6) "5000"
127.0.0.1:6379[15]> ZCOUNT salary 2000 5000
(integer) 3
127.0.0.1:6379[15]> ZCOUNT salary 3000 5000
(integer) 2

4、ZINCRBY key increment member

为有序集 key 的成员 member 的 score 值加上增量 increment 。 可以通过传递一个负数值 increment ，让 score 减去相应的值，比如 ZINCRBY key -5 member，就是让member的 score 值减去 5 。 当 key 不存在，或 member 不是 key 的成员时，ZINCRBY key increment member 等同于 ZADD key increment member 。 当 key 不是有序集类型时，返回一个错误。 score 值可以是整数值或双精度浮点数。

返回值: member 成员的新 score 值，以字符串形式表示。

示例：

127.0.0.1:6379[15]> ZADD salary 2000 tom 3500 peter 5000 jack
(integer) 3
127.0.0.1:6379[15]> ZSCORE salary tom
"2000"
127.0.0.1:6379[15]> ZINCRBY salary 2000 tom
"4000"
127.0.0.1:6379[15]> ZSCORE salary tom
"4000"

5、ZRANGE key start stop [WITHSCORES]

返回有序集 key 中，指定区间内的成员。

返回值: 指定区间内，带有 score 值 (可选) 的有序集成员的列表。

示例：

127.0.0.1:6379[15]> ZADD salary 3500 jack 5000 tom 10086 boss
(integer) 3
127.0.0.1:6379[15]> ZRANGE salary 1 2 WITHSCORES
1) "tom"
2) "5000"
3) "boss"
4) "10086"
127.0.0.1:6379[15]> ZRANGE salary 0 200000 WITHSCORES
1) "jack"
2) "3500"
3) "tom"
4) "5000"
5) "boss"
6) "10086"
127.0.0.1:6379[15]> ZRANGE salary 0 -1 WITHSCORES
1) "jack"
2) "3500"
3) "tom"
4) "5000"
5) "boss"
6) "10086"
127.0.0.1:6379[15]> ZRANGE salary 200000 3000000 WITHSCORES
(empty list or set)

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

返回有序集 key 中，所有 score 值介于 min 和 max 之间 (包括等于 min 或 max ) 的成员。有序集成员按score 值递增 (从小到大) 次序排列。

返回值: 指定区间内，带有 score 值 (可选) 的有序集成员的列表。

示例：

127.0.0.1:6379[15]> ZADD salary 2500 jack
(integer) 1
127.0.0.1:6379[15]> ZADD salary 5000 tom
(integer) 1
127.0.0.1:6379[15]> ZADD salary 12000 peter
(integer) 1
127.0.0.1:6379[15]> ZRANGEBYSCORE salary -inf +inf
1) "jack"
2) "tom"
3) "peter"
127.0.0.1:6379[15]> ZRANGEBYSCORE salary -inf +inf WITHSCORES
1) "jack"
2) "2500"
3) "tom"
4) "5000"
5) "peter"
6) "12000"
127.0.0.1:6379[15]> ZRANGEBYSCORE salary -inf 5000 WITHSCORES
1) "jack"
2) "2500"
3) "tom"
4) "5000"
127.0.0.1:6379[15]> ZRANGEBYSCORE salary (5000 400000
1) "peter"

7、ZRANK key member

返回有序集 key 中成员 member 的排名。其中有序集成员按 score 值递增 (从小到大) 顺序排列。 排名以 0 为底，也就是说，score 值最小的成员排名为 0 。 使用ZREVRANK 命令可以获得成员按 score 值递减 (从大到小) 排列的排名。

返回值: 如果 member 是有序集 key 的成员，返回 member 的排名。 如果 member 不是有序集 key 的成员，返回 nil 。

示例：

127.0.0.1:6379[15]> ZRANGE salary 0 -1 WITHSCORES
1) "tom"
2) "2000"
3) "peter"
4) "3500"
5) "jack"
6) "5000"
127.0.0.1:6379[15]> ZRANK salary tom
(integer) 0

8、ZREM key member [member …]

移除有序集 key 中的一个或多个成员，不存在的成员将被忽略。 当 key 存在但不是有序集类型时，返回一个错误。

返回值: 被成功移除的成员的数量，不包括被忽略的成员。

示例：

127.0.0.1:6379[15]> ZRANGE page_rank 0 -1 WITHSCORES
1) "bing.com"
2) "6"
3) "baidu.com"
4) "9"
5) "google.com"
6) "10"

127.0.0.1:6379[15]> ZREM page_rank google.com           # 移除单个元素
(integer) 1
127.0.0.1:6379[15]> ZRANGE page_rank 0 -1 WITHSCORES
1) "bing.com"
2) "6"
3) "baidu.com"
4) "9"

127.0.0.1:6379[15]> ZREM page_rank baidu.com bing.com   # 移除多个元素
(integer) 2
127.0.0.1:6379[15]> ZRANGE page_rank 0 -1 WITHSCORES
(empty list or set)

127.0.0.1:6379[15]> ZREM page_rank non-exists-element   # 移除不存在的元素
(integer) 0

9、ZREVRANGE key start stop [WITHSCORES]

返回有序集 key 中，指定区间内的成员。 其中成员的位置按 score 值递减 (从大到小) 来排列。 具有相同 score 值的成员按字典序的逆序 (reverse lexicographical order) 排列。 除了成员按 score 值递减的次序排列这一点外，ZREVRANGE 命令的其他方面和ZRANGE 命令一样。

返回值： 指定区间内，带有分数值(可选)的有序集成员的列表。

示例：

127.0.0.1:6379[15]> ZRANGE salary 0 -1 WITHSCORES
1) "tom"
2) "2000"
3) "peter"
4) "3500"
5) "jack"
6) "5000"
127.0.0.1:6379[15]> ZREVRANGE salary 0 -1 WITHSCORES
1) "jack"
2) "5000"
3) "peter"
4) "3500"
5) "tom"
6) "2000"

10、ZREVRANK key member

返回有序集 key 中成员 member 的排名。其中有序集成员按 score 值递减 (从大到小) 排序。 排名以 0 为底，也就是说，score 值最大的成员排名为 0 。 使用ZRANK 命令可以获得成员按 score 值递增 (从小到大) 排列的排名。

返回值: 如果 member 是有序集 key 的成员，返回 member 的排名。 如果 member 不是有序集 key 的成员，返回 nil 。

示例：

127.0.0.1:6379[15]>  ZRANGE salary 0 -1 WITHSCORES
1) "jack"
2) "3500"
3) "tom"
4) "5000"
5) "boss"
6) "10086"
127.0.0.1:6379[15]> ZREVRANK salary tom
(integer) 1
127.0.0.1:6379[15]> ZREVRANK salary boss
(integer) 0

11、ZSCORE key member

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

**返回值: **member 成员的 score 值，以字符串形式表示。

示例：

127.0.0.1:6379[15]> ZADD salary 2000 tom 3500 peter 5000 jack
(integer) 3
127.0.0.1:6379[15]>  ZSCORE salary peter
"3500"

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

返回有序集 key 中，score 值介于 max 和 min 之间 (默认包括等于 max 或 min ) 的所有的成员。有序集成员按 score 值递减 (从大到小) 的次序排列。

返回值: 指定区间内，带有 score 值 (可选) 的有序集成员的列表。

示例：

127.0.0.1:6379[15]> ZADD salary 10086 jack 5000 tom 7000 peter 3500 joe
(integer) 4
127.0.0.1:6379[15]> ZREVRANGEBYSCORE salary +inf -inf
1) "jack"
2) "peter"
3) "tom"
4) "joe"
127.0.0.1:6379[15]> ZREVRANGEBYSCORE salary +inf -inf
1) "jack"
2) "peter"
3) "tom"
4) "joe"
127.0.0.1:6379[15]> ZREVRANGEBYSCORE salary 10000 2000
1) "peter"
2) "tom"
3) "joe"

13、ZREMRANGEBYRANK key start stop

移除有序集 key 中，指定排名 (rank) 区间内的所有成员。 区间分别以下标参数 start 和 stop 指出，包含 start 和 stop 在内。 下标参数 start 和 stop 都以 0 为底，也就是说，以 0 表示有序集第一个成员，以 1 表示有序集第二个成员，以此类推。 你也可以使用负数下标，以 -1 表示最后一个成员，-2 表示倒数第二个成员，以此类推。

返回值: 被移除成员的数量。

示例：

127.0.0.1:6379[15]> ZADD salary 2000 jack
(integer) 1
127.0.0.1:6379[15]> ZADD salary 5000 tom
(integer) 1
127.0.0.1:6379[15]> ZADD salary 3500 peter
(integer) 1
127.0.0.1:6379[15]> ZREMRANGEBYRANK salary 0 1
(integer) 2
127.0.0.1:6379[15]> ZRANGE salary 0 -1 WITHSCORES
1) "tom"
2) "5000"

14、ZREMRANGEBYSCORE key min max

移除有序集 key 中，所有 score 值介于 min 和 max 之间 (包括等于 min 或 max ) 的成员。 自版本 2.1.6 开始，score 值等于 min 或 max 的成员也可以不包括在内。

返回值: 被移除成员的数量。

示例：

127.0.0.1:6379[15]> ZADD salary 2000 tom 3500 peter 5000 jack
(integer) 3
127.0.0.1:6379[15]> ZRANGE salary 0 -1 WITHSCORES
1) "tom"
2) "2000"
3) "peter"
4) "3500"
5) "jack"
6) "5000"
127.0.0.1:6379[15]> ZREMRANGEBYSCORE salary 1500 3500
(integer) 2
127.0.0.1:6379[15]> ZRANGE salary 0 -1 WITHSCORES
1) "jack"
2) "5000"

（结束）

参考：http://blog.csdn.net/thinkercode/article/details/46575813