Redis——有序集合(sorted set)

Redis 有序集合和集合同樣也是string類型元素的集合,且不容許重複的成員。html

不一樣的是每一個元素都會關聯一個double類型的分數。redis正是經過分數來爲集合中的成員進行從小到大的排序。程序員

有序集合的成員是惟一的,但分數(score)卻能夠重複。redis

集合是經過哈希表實現的,因此添加,刪除,查找的複雜度都是O(1)。 集合中最大的成員數爲 2^32 - 1 (4294967295, 每一個集合可存儲40多億個成員)。測試

 

Redis有序集合命令google

一、ZADD set1 score1 member  [....scoreN  memberN]htm

Redis Zadd 命令用於將一個或多個成員元素及其分數值加入到有序集當中。排序

若是某個成員已是有序集的成員,那麼更新這個成員的分數值,並經過從新插入這個成員元素,來保證該成員在正確的位置上。three

分數值能夠是整數值或雙精度浮點數。ip

若是有序集合 set不存在,則建立一個空的有序集並執行 ZADD 操做。element

當 set 存在但不是有序集類型時,返回一個錯誤。

注意: 在 Redis 2.4 版本之前, ZADD 每次只能添加一個元素。

返回被成功添加的新成員的數量,不包括那些被更新的、已經存在的成員。

redis> ZADD myzset 1 "one"
(integer) 1
redis> ZADD myzset 1 "uno"
(integer) 1
redis> ZADD myzset 2 "two" 3 "three"
(integer) 2
redis> ZRANGE myzset 0 -1 WITHSCORES
1) "one"
2) "1"
3) "uno"
4) "1"
5) "two"
6) "2"
7) "three"
8) "3"
redis>

 

二、ZCARD set1

用於計算集合中元素的數量,當set存在且是有序集類型時,返回有序集的基數。當key不存在時,返回0。

redis> ZADD myzset 1 "one"
(integer) 1
redis> ZADD myzset 2 "two"
(integer) 1
redis> ZCARD myzset
(integer) 2
redis>

 

三、ZCOUNT set1 min max

Redis Zcount命令用於計算有序集合中指定分數區間的成員數量

redis 127.0.0.1:6379> ZADD myzset 1 "hello"
(integer) 1
redis 127.0.0.1:6379> ZADD myzset 1 "foo"
(integer) 1
redis 127.0.0.1:6379> ZADD myzset 2 "world" 3 "bar"
(integer) 2
redis 127.0.0.1:6379> ZCOUNT myzset 1 3
(integer) 4

 

四、ZINCRBY  set1 increment member

Redis Zincrby命令對有序集合中指定成員的分數加上增量increment。

能夠經過傳遞一個負數值 increment ,讓分數減去相應的值,好比 ZINCRBY set -5 member ,就是讓 member 的 score 值減去 5 。

當 set不存在,或不是 set 的成員時, ZINCRBY set increment member 等同於 ZADD set increment member 。

當 set 不是有序集類型時,返回一個錯誤。

分數值能夠是整數值或雙精度浮點數。

返回值是member成員的新分數值,以字符串形式表示。

redis> ZADD myzset 1 "one"
(integer) 1
redis> ZADD myzset 2 "two"
(integer) 1
redis> ZINCRBY myzset 2 "one"
"3"
redis> ZRANGE myzset 0 -1 WITHSCORES
1) "two"
2) "2"
3) "one"
4) "3"
redis>

 

五、ZINTERSTORE destination numsets set1 [set1...] [WEIGHTS weight [weight...]] [AGGREGATE SUM | MIN | MAX ]

Redis Zinterstore 命令計算給定的一個或多個有序集的交集,其中給定 set 的數量必須以 numsets 參數指定,並將該交集(結果集)儲存到 destination 。

默認狀況下,結果集中某個成員的分數值是全部給定集下該成員分數值之和。

返回值爲保存到目標結果集的成員數量。

# 有序集 mid_test
redis 127.0.0.1:6379> ZADD mid_test 70 "Li Lei"
(integer) 1
redis 127.0.0.1:6379> ZADD mid_test 70 "Han Meimei"
(integer) 1
redis 127.0.0.1:6379> ZADD mid_test 99.5 "Tom"
(integer) 1

# 另外一個有序集 fin_test
redis 127.0.0.1:6379> ZADD fin_test 88 "Li Lei"
(integer) 1
redis 127.0.0.1:6379> ZADD fin_test 75 "Han Meimei"
(integer) 1
redis 127.0.0.1:6379> ZADD fin_test 99.5 "Tom"
(integer) 1

# 交集
redis 127.0.0.1:6379> ZINTERSTORE sum_point 2 mid_test fin_test
(integer) 3

# 顯示有序集內全部成員及其分數值
redis 127.0.0.1:6379> ZRANGE sum_point 0 -1 WITHSCORES     
1) "Han Meimei"
2) "145"
3) "Li Lei"
4) "158"
5) "Tom"
6) "199"

 

六、ZLEXCOUNT  set1  min max

Redis Zlexcount命令在計算有序集合中指定字典區間內成員數量。

返回值爲指定區間內的成員數量。

redis 127.0.0.1:6379> ZADD myzset 0 a 0 b 0 c 0 d 0 e
(integer) 5
redis 127.0.0.1:6379> ZADD myzset 0 f 0 g
(integer) 2
redis 127.0.0.1:6379> ZLEXCOUNT myzset - +
(integer) 7
redis 127.0.0.1:6379> ZLEXCOUNT myzset [b [f
(integer) 5

 

七、ZRANGE set start stop [ WITHSCORES ]

Redis Zrange 返回有序集中,指定區間內的成員。

其中成員的位置按分數值遞增(從小到大)來排序。

具備相同分數值的成員按字典序(lexicographical order )來排列。

若是你須要成員按

值遞減(從大到小)來排列,請使用 ZREVRANGE 命令。

下標參數 start 和 stop 都以 0 爲底,也就是說,以 0 表示有序集第一個成員,以 1 表示有序集第二個成員,以此類推。

你也可使用負數下標,以 -1 表示最後一個成員, -2 表示倒數第二個成員,以此類推。

redis 127.0.0.1:6379> ZRANGE salary 0 -1 WITHSCORES             # 顯示整個有序集成員
1) "jack"
2) "3500"
3) "tom"
4) "5000"
5) "boss"
6) "10086"

redis 127.0.0.1:6379> ZRANGE salary 1 2 WITHSCORES              # 顯示有序集下標區間 1 至 2 的成員
1) "tom"
2) "5000"
3) "boss"
4) "10086"

redis 127.0.0.1:6379> ZRANGE salary 0 200000 WITHSCORES         # 測試 end 下標超出最大下標時的狀況
1) "jack"
2) "3500"
3) "tom"
4) "5000"
5) "boss"
6) "10086"

redis > ZRANGE salary 200000 3000000 WITHSCORES                  # 測試當給定區間不存在於有序集時的狀況
(empty list or set)

 

八、ZRANGEBYLEX  set  min max [ LIMIT offset count ]

Redis Zrangebylex經過字典區間返回有序集合的成員。

redis 127.0.0.1:6379> ZADD myzset 0 a 0 b 0 c 0 d 0 e 0 f 0 g
(integer) 7
redis 127.0.0.1:6379> ZRANGEBYLEX myzset - [c
1) "a"
2) "b"
3) "c"
redis 127.0.0.1:6379> ZRANGEBYLEX myzset - (c
1) "a"
2) "b"
redis 127.0.0.1:6379> ZRANGEBYLEX myzset [aaa (g
1) "b"
2) "c"
3) "d"
4) "e"
5) "f"
redis>

 

九、ZRANGEBYSCORE  set  min max  [ WITHSCORES ] [LIMIT offset count ]

 

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

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

默認狀況下,區間的取值使用閉區間 (小於等於或大於等於),你也能夠經過給參數前增長 ( 符號來使用可選的開區間 (小於或大於)。

redis 127.0.0.1:6379> ZADD salary 2500 jack                        # 測試數據
(integer) 0
redis 127.0.0.1:6379> ZADD salary 5000 tom
(integer) 0
redis 127.0.0.1:6379> ZADD salary 12000 peter
(integer) 0

redis 127.0.0.1:6379> ZRANGEBYSCORE salary -inf +inf               # 顯示整個有序集
1) "jack"
2) "tom"
3) "peter"

redis 127.0.0.1:6379> ZRANGEBYSCORE salary -inf +inf WITHSCORES    # 顯示整個有序集及成員的 score 值
1) "jack"
2) "2500"
3) "tom"
4) "5000"
5) "peter"
6) "12000"

redis 127.0.0.1:6379> ZRANGEBYSCORE salary -inf 5000 WITHSCORES    # 顯示工資 <=5000 的全部成員
1) "jack"
2) "2500"
3) "tom"
4) "5000"

redis 127.0.0.1:6379> ZRANGEBYSCORE salary (5000 400000            # 顯示工資大於 5000 小於等於 400000 的成員
1) "peter"

 

 

十、ZRANGE  set  member

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

若是成員是有序集合set的成員,返回member的排名。若是成員不是有序集set的成員,返回nil。

redis 127.0.0.1:6379> ZRANGE salary 0 -1 WITHSCORES        # 顯示全部成員及其 score 值
1) "peter"
2) "3500"
3) "tom"
4) "4000"
5) "jack"
6) "5000"

redis 127.0.0.1:6379> ZRANK salary tom                     # 顯示 tom 的薪水排名,第二
(integer) 1

 

十一、ZREM  set member  [ member... ]

Redis Zrem 命令用於移除有序集中的一個或多個成員,不存在的成員將被忽略。

當 set 存在但不是有序集類型時,返回一個錯誤。

注意: 在 Redis 2.4 版本之前, ZREM 每次只能刪除一個元素。

返回被成功移除的成員的數量,不包括被忽略的成員。

# 測試數據

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


# 移除單個元素

redis 127.0.0.1:6379> ZREM page_rank google.com
(integer) 1

redis 127.0.0.1:6379> ZRANGE page_rank 0 -1 WITHSCORES
1) "bing.com"
2) "8"
3) "baidu.com"
4) "9"


# 移除多個元素

redis 127.0.0.1:6379> ZREM page_rank baidu.com bing.com
(integer) 2

redis 127.0.0.1:6379> ZRANGE page_rank 0 -1 WITHSCORES
(empty list or set)


# 移除不存在元素

redis 127.0.0.1:6379> ZREM page_rank non-exists-element
(integer) 0

 

十二、ZREMRANGEBYLEX  set  min  max

Redis Zremrangebylex 命令用於移除有序集合中給定的字典區間的全部成員。返回被成功移除的成員的數量,不包括被忽略的成員。

redis 127.0.0.1:6379> ZADD myzset 0 aaaa 0 b 0 c 0 d 0 e
(integer) 5
redis 127.0.0.1:6379> ZADD myzset 0 foo 0 zap 0 zip 0 ALPHA 0 alpha
(integer) 5
redis 127.0.0.1:6379> ZRANGE myzset 0 -1
1) "ALPHA"
 2) "aaaa"
 3) "alpha"
 4) "b"
 5) "c"
 6) "d"
 7) "e"
 8) "foo"
 9) "zap"
10) "zip"
redis 127.0.0.1:6379> ZREMRANGEBYLEX myzset [alpha [omega
(integer) 6
redis 127.0.0.1:6379> ZRANGE myzset 0 -1
1) "ALPHA"
2) "aaaa"
3) "zap"
4) "zip"
redis>

 

1三、ZREMRANGEBYRANK  set  start stop

Redis Zremrangebyrank 命令用於移除有序集中,指定排名(rank)區間內的全部成員。返回被移除成員的數量。

redis 127.0.0.1:6379> ZADD salary 2000 jack
(integer) 1
redis 127.0.0.1:6379> ZADD salary 5000 tom
(integer) 1
redis 127.0.0.1:6379> ZADD salary 3500 peter
(integer) 1

redis 127.0.0.1:6379> ZREMRANGEBYRANK salary 0 1       # 移除下標 0 至 1 區間內的成員
(integer) 2

redis 127.0.0.1:6379> ZRANGE salary 0 -1 WITHSCORES    # 有序集只剩下一個成員
1) "tom"
2) "5000"

 

1四、ZREMRANGEBYSCORE  set min max

Redis Zremrangebyscore 命令用於移除有序集中,指定分數(score)區間內的全部成員。返回被移除成員的數量。

redis 127.0.0.1:6379> ZRANGE salary 0 -1 WITHSCORES          # 顯示有序集內全部成員及其 score 值
1) "tom"
2) "2000"
3) "peter"
4) "3500"
5) "jack"
6) "5000"

redis 127.0.0.1:6379> ZREMRANGEBYSCORE salary 1500 3500      # 移除全部薪水在 1500 到 3500 內的員工
(integer) 2

redis> ZRANGE salary 0 -1 WITHSCORES          # 剩下的有序集成員
1) "jack"
2) "5000"

 

1五、ZREVRANGEBYSCORE set  max  min [ WITHSCORES ] [ LIMIT offset count ]

Redis Zrevrangebyscore 返回有序集中指定分數區間內的全部的成員。有序集成員按分數值遞減(從大到小)的次序排列。

具備相同分數值的成員按字典序的逆序(reverse lexicographical order )排列。

除了成員按分數值遞減的次序排列這一點外, ZREVRANGEBYSCORE 命令的其餘方面和 ZRANGEBYSCORE 命令同樣。返回指定區間內,帶有分數值(可選)的有序集成員的列表。

redis 127.0.0.1:6379> ZADD salary 10086 jack
(integer) 1
redis > ZADD salary 5000 tom
(integer) 1
redis 127.0.0.1:6379> ZADD salary 7500 peter
(integer) 1
redis 127.0.0.1:6379> ZADD salary 3500 joe
(integer) 1

redis 127.0.0.1:6379> ZREVRANGEBYSCORE salary +inf -inf   # 逆序排列全部成員
1) "jack"
2) "peter"
3) "tom"
4) "joe"

redis 127.0.0.1:6379> ZREVRANGEBYSCORE salary 10000 2000  # 逆序排列薪水介於 10000 和 2000 之間的成員
1) "peter"
2) "tom"
3) "joe"

 

1六、ZREVRANGE set  start  stop [ WITHSCORES ]

Redis Zrevrange 命令返回有序集中,指定區間內的成員。

其中成員的位置按分數值遞減(從大到小)來排列。

具備相同分數值的成員按字典序的逆序(reverse lexicographical order)排列。

除了成員按分數值遞減的次序排列這一點外, ZREVRANGE 命令的其餘方面和 ZRANGE 命令同樣。

redis 127.0.0.1:6379> ZRANGE salary 0 -1 WITHSCORES        # 遞增排列
1) "peter"
2) "3500"
3) "tom"
4) "4000"
5) "jack"
6) "5000"

redis 127.0.0.1:6379> ZREVRANGE salary 0 -1 WITHSCORES     # 遞減排列
1) "jack"
2) "5000"
3) "tom"
4) "4000"
5) "peter"
6) "3500"

 

1七、ZREVRANK  set  member

Redis Zrevrank 命令返回有序集中成員的排名。其中有序集成員按分數值遞減(從大到小)排序。

排名以 0 爲底,也就是說, 分數值最大的成員排名爲 0 。

使用 ZRANK 命令能夠得到成員按分數值遞增(從小到大)排列的排名。

若是成員是有序集set的成員,返回成員的排名。若是成員不是有序集set的成員,返回nil。

redis 127.0.0.1:6379> ZRANGE salary 0 -1 WITHSCORES     # 測試數據
1) "jack"
2) "2000"
3) "peter"
4) "3500"
5) "tom"
6) "5000"

redis 127.0.0.1:6379> ZREVRANK salary peter     # peter 的工資排第二
(integer) 1

redis 127.0.0.1:6379> ZREVRANK salary tom       # tom 的工資最高
(integer) 0

 

1八、ZSCORE  set member

Redis Zscore 命令返回有序集中,成員的分數值。 若是成員元素不是有序集 set 的成員,或set 不存在,返回 nil 。

redis 127.0.0.1:6379> ZRANGE salary 0 -1 WITHSCORES    # 測試數據
1) "tom"
2) "2000"
3) "peter"
4) "3500"
5) "jack"
6) "5000"

redis 127.0.0.1:6379> ZSCORE salary peter              # 注意返回值是字符串
"3500"

 

1九、ZUNINONSTORE  destination numsets  set1 [ set2...setN ]  [ WEIGHTS  weight [ weight ... ]] [ AGGREGATE  SUM | MIN | MAX ]

Redis Zunionstore 命令計算給定的一個或多個有序集的並集,其中給定 set 的數量必須以 numsets 參數指定,並將該並集(結果集)儲存到 destination 。

默認狀況下,結果集中某個成員的分數值是全部給定集下該成員分數值之和 。

返回保存到destination的結果集的成員數量。

redis 127.0.0.1:6379> ZRANGE programmer 0 -1 WITHSCORES
1) "peter"
2) "2000"
3) "jack"
4) "3500"
5) "tom"
6) "5000"

redis 127.0.0.1:6379> ZRANGE manager 0 -1 WITHSCORES
1) "herry"
2) "2000"
3) "mary"
4) "3500"
5) "bob"
6) "4000"

redis 127.0.0.1:6379> ZUNIONSTORE salary 2 programmer manager WEIGHTS 1 3   # 公司決定加薪。。。除了程序員。。。
(integer) 6

redis 127.0.0.1:6379> ZRANGE salary 0 -1 WITHSCORES
1) "peter"
2) "2000"
3) "jack"
4) "3500"
5) "tom"
6) "5000"
7) "herry"
8) "6000"
9) "mary"
10) "10500"
11) "bob"
12) "12000"

 

20、ZSCAN  set  cursor [ MATCH pattern ] [ COUNT count ]

Redis Zscan 命令用於迭代有序集合中的元素(包括元素成員和元素分值)。

返回的每一個元素都是一個有序集合元素,一個有序集合元素由一個成員(member)和一個分值(score)組成。