Redis 有序集合（zset）命令詳解

sorted set官網連結： http://www.redis.cn/commands.html#sorted_set

新增

1. ZADD 新增（一個或多個）

ZADD key score1 member1 [score2 member2]

向有序集合新增一個或多個成員，或者更新已存在成員的分數。
Redis zadd 命令用於將一個或多個成員元素及其分數值加入到有序集當中。
如果某個成員已經是有序集的成員，那麼更新這個成員的分數值，並通過重新插入這個成員元素，來保證該成員在正確的位置上。

分數值可以是整數值或雙精度浮點數。
如果有序集合 key 不存在，則建立一個空的有序集並執行 ZADD 操作。
當 key 存在但不是有序集型別時，返回一個錯誤.

修改

2. ZINCRBY 修改成員分數

ZINCRBY key increment member

有序集合中對指定成員的分數加上增量 increment
Redis zincrby 命令對有序集合中指定成員的分數加上增量 increment
可以通過傳遞一個負數值 increment ，讓分數減去相應的值，比如 ZINCRBY key -5 member ，就是讓 member 的 score 值減去 5 。當 key 不存在，或分數不是 key 的成員時， ZINCRBY key increment member 等同於 ZADD key increment member 。
當 key 不是有序集型別時，返回一個錯誤。
分數值可以是整數值或雙精度浮點數。
返回值：member 成員的新分數值，以字串形式表示。

查詢

3. ZRANGE 查詢 （索引查詢-分數值遞增）

ZRANGE key start stop [WITHSCORES]

通過索引區間返回有序集合成指定區間內的成員
Redis zrange 返回有序集中，指定區間內的成員。其中成員的位置按分數值遞增(從小到大)來排序。具有相同分數值的成員按字典序(lexicographical order )來排列。
如果你需要成員按值遞減(從大到小)來排列，請使用 ZREVRANGE 命令。
下標引數 start 和 stop 都以 0 為底，也就是說，以 0 表示有序集第一個成員，以 1 表示有序集第二個成員，以此類推。
你也可以使用負數下標，以 -1 表示最後一個成員， -2 表示倒數第二個成員，以此類推。
返回值:指定區間內，帶有分數值(可選)的有序整合員的列表。

4. ZCARD 查詢集合成員數量

ZCARD key

獲取有序集合的成員數
Redis zcard 命令用於計算集合中元素的數量。
返回值:當 key 存在且是有序集型別時，返回有序集的基數。 當 key 不存在時，返回 0

5. ZCOUNT 查詢指定區間分數的成員數量

ZCOUNT key min max

計算在有序集合中指定區間分數的成員數
Redis zcount 命令用於計算有序集合中指定分數區間的成員數量。
返回值：分數值在 min 和 max 之間的成員的數量。

6. ZLEXCOUNT 查詢指定字典區間的成員數量

ZLEXCOUNT key min max

在有序集合中計算指定字典區間內成員數量
返回值:指定區間內的成員數量。

7. ZRANGEBYLEX 查詢指定字典區間的成員

ZRANGEBYLEX key min max [LIMIT offset count]

通過字典區間返回有序集合的成員
返回值：指定區間內的元素列表

8. ZRANGEBYSCORE 查詢指定分數區間的成員-分數值遞增

ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT]

通過分數返回有序集合指定區間內的成員
Redis zrangebyscore 返回有序集合中指定分數區間的成員列表。有序整合員按分數值遞增(從小到大)次序排列。

具有相同分數值的成員按字典序來排列(該屬性是有序集提供的，不需要額外的計算)。

預設情況下，區間的取值使用閉區間 (小於等於或大於等於)，你也可以通過給引數前增加 ( 符號來使用可選的開區間 (小於或大於)。

9. ZRANK 查詢指定成員的索引 （分數值遞增排序）

ZRANK key member

返回有序集合中指定成員的索引
Redis zrank 返回有序集中指定成員的排名。其中有序整合員按分數值遞增(從小到大)順序排列。

10. ZREVRANK 查詢指定成員的索引（分數值遞減排序）

ZREVRANK key member

返回有序集合中指定成員的排名，有序整合員按分數值遞減(從大到小)排序
返回值：如果成員是有序集 key 的成員，返回成員的排名。 如果成員不是有序集 key 的成員，返回 nil 。
Redis zrevrank 命令返回有序集中成員的排名。其中有序整合員按分數值遞減(從大到小)排序。
排名以 0 為底，也就是說， 分數值最大的成員排名為 0 。
使用 ZRANK 命令可以獲得成員按分數值遞增(從小到大)排列的排名。

11. ZREVRANGE （索引查詢-分數值遞減）

ZREVRANGE key start stop [WITHSCORES]

返回有序集中指定區間內的成員，通過索引，分數從高到底
Redis zrevrange 命令返回有序集中，指定區間內的成員。
其中成員的位置按分數值遞減(從大到小)來排列。
具有相同分數值的成員按字典序的逆序(reverse lexicographical order)排列。
除了成員按分數值遞減的次序排列這一點外， ZREVRANGE 命令的其他方面和 ZRANGE 命令一樣。
返回值:指定區間內，帶有分數值(可選)的有序整合員的列表。

12. ZREVRANGEBYSCORE 查詢指定分數區間的成員-分數值遞減

ZREVRANGEBYSCORE key max min [WITHSCORES]

返回有序集中指定分數區間內的成員，分數從高到低排序
Redis zrevrangebyscore 返回有序集中指定分數區間內的所有的成員。有序整合員按分數值遞減(從大到小)的次序排列。
具有相同分數值的成員按字典序的逆序(reverse lexicographical order )排列。
除了成員按分數值遞減的次序排列這一點外， ZREVRANGEBYSCORE 命令的其他方面和 ZRANGEBYSCORE 命令一樣。

13. ZSCORE 查詢成員的分數值

ZSCORE key member

返回有序集中，成員的分數值
返回值:成員的分數值，以字串形式表示。
Redis zscore 命令返回有序集中，成員的分數值。 如果成員元素不是有序集 key 的成員，或 key 不存在，返回 nil 。

刪除

14. ZREM 刪除一個或多個成員

ZREM key member [member …]

移除有序集合中的一個或多個成員
Redis zrem 命令用於移除有序集中的一個或多個成員，不存在的成員將被忽略。
當 key 存在但不是有序集型別時，返回一個錯誤。
注意： 在 Redis 2.4 版本以前， ZREM 每次只能刪除一個元素。
返回值：被成功移除的成員的數量，不包括被忽略的成員。

15. ZREMRANGEBYLEX 刪除指定字典區間的成員

ZREMRANGEBYLEX key min max

移除有序集合中給定的字典區間的所有成員
Redis zremrangebylex 命令用於移除有序集合中給定的字典區間的所有成員
返回值：被成功移除的成員的數量，不包括被忽略的成員。

16. ZREMRANGEBYRANK 刪除指定排名區間的成員

ZREMRANGEBYRANK key start stop

移除有序集合中給定的排名區間的所有成員
Redis zremrangebyrank 命令用於移除有序集中，指定排名(rank)區間內的所有成員。
返回值：被移除成員的數量。

17. ZREMRANGEBYSCORE 刪除指定分數區間的成員

ZREMRANGEBYSCORE key min max

移除有序集合中給定的分數區間的所有成員
Redis zremrangebyscore 命令用於移除有序集中，指定分數（score）區間內的所有成員。
返回值：被移除成員的數量。

合併

18. ZINTERSTORE 合併多個集合到另一個新集合中

ZINTERSTORE destination numkeys key [key …]

計算給定的一個或多個有序集的交集並將結果集儲存在新的有序集合 key 中
Redis zinterstore 命令計算給定的一個或多個有序集的交集，其中給定 key 的數量必須以 numkeys 引數指定，並將該交集(結果集)儲存到 destination 。
預設情況下，結果集中某個成員的分數值是所有給定集下該成員分數值之和。
返回值：儲存到目標結果集的的成員數量。