1. 概述:

Sorted-Sets和Sets類型極為相似，它們都是字符串的集合，都不允許重復(fù)的成員出現(xiàn)在一個(gè)Set中。它們之間的主要差別是Sorted-Sets中的每一個(gè)成員都會(huì)有一個(gè)分?jǐn)?shù)(score)與之關(guān)聯(lián)，Redis正是通過分?jǐn)?shù)來為集合中的成員進(jìn)行從小到大的排序。然而需要額外指出的是，盡管Sorted-Sets中的成員必須是唯一的，但是分?jǐn)?shù)(score)卻是可以重復(fù)的。在Sorted-Set中添加、刪除或更新一個(gè)成員都是非?？焖俚牟僮鳎鋾r(shí)間復(fù)雜度為集合中成員數(shù)量的對(duì)數(shù)(二分查找)。由于Sorted-Sets中的成員在集合中的位置是有序的，因此，即便是訪問位于集合中部的成員也仍然是非常高效的。事實(shí)上，Redis所具有的這一特征在很多其它類型的數(shù)據(jù)庫中是很難實(shí)現(xiàn)的，換句話說，在該點(diǎn)上要想達(dá)到和Redis同樣的高效，在其它數(shù)據(jù)庫中進(jìn)行建模是非常困難的。

2. 命令列表

• ZADD key score member [score] [member] O(log(N)) 時(shí)間復(fù)雜度中的N表示Sorted-Sets中成員的數(shù)量。/ 本次操作實(shí)際插入的成員數(shù)量。
  添加參數(shù)中指定的所有成員及其分?jǐn)?shù)到指定key的Sorted-Set中，在該命令中我們可以指定多組score/member作為參數(shù)。如果在添加時(shí)參數(shù)中的某一成員已經(jīng)存在，該命令將更新此成員的分?jǐn)?shù)為新值，同時(shí)再將該成員基于新值重新排序。如果鍵不存在，該命令將為該鍵創(chuàng)建一個(gè)新的Sorted-Sets Value，并將score/member對(duì)插入其中。如果該鍵已經(jīng)存在，但是與其關(guān)聯(lián)的Value不是Sorted-Sets類型，相關(guān)的錯(cuò)誤信息將被返回。

• ZCARD key O(1) 獲取與該Key相關(guān)聯(lián)的Sorted-Sets中包含的成員數(shù)量。 返回Sorted-Sets中的成員數(shù)量，如果該Key不存在，返回0。

• ZCOUNT key min max O(log(N)+M) 該命令用于獲取分?jǐn)?shù)(score)在min和max之間的成員數(shù)量。/ 分?jǐn)?shù)指定范圍內(nèi)成員的數(shù)量。
  針對(duì)min和max參數(shù)需要額外說明的是，-inf和+inf分別表示Sorted-Sets中分?jǐn)?shù)的最高值和最低值。缺省情況下，min和max表示的范圍是閉區(qū)間范圍，即min <= score <= max內(nèi)的成員將被返回。然而我們可以通過在min和max的前面添加"("字符來表示開區(qū)間，如(min max表示min < score <= max，而(min (max表示min < score < max。

• ZINCRBY key increment member O(log(N)) / 以字符串形式表示的新分?jǐn)?shù)。
  該命令將為指定Key中的指定成員增加指定的分?jǐn)?shù)。如果成員不存在，該命令將添加該成員并假設(shè)其初始分?jǐn)?shù)為0，此后再將其分?jǐn)?shù)加上increment。如果Key不存，該命令將創(chuàng)建該Key及其關(guān)聯(lián)的Sorted-Sets，并包含參數(shù)指定的成員，其分?jǐn)?shù)為increment參數(shù)。如果與該Key關(guān)聯(lián)的不是Sorted-Sets類型，相關(guān)的錯(cuò)誤信息將被返回。

• ZRANGE key start stop [WITHSCORES] O(log(N)+M) 時(shí)間復(fù)雜度中的N表示Sorted-Set中成員的數(shù)量，M則表示返回的成員數(shù)量。/ 返回索引在start和stop之間的成員列表。
  該命令返回順序在參數(shù)start和stop指定范圍內(nèi)的成員，這里start和stop參數(shù)都是0-based，即0表示第一個(gè)成員，-1表示最后一個(gè)成員。如果start大于該Sorted-Set中的最大索引值，或start > stop，此時(shí)一個(gè)空集合將被返回。如果stop大于最大索引值，該命令將返回從start到集合的最后一個(gè)成員。如果命令中帶有可選參數(shù)WITHSCORES選項(xiàng)，該命令在返回的結(jié)果中將包含每個(gè)成員的分?jǐn)?shù)值，如value1,score1,value2,score2...。

• ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT offset count] O(log(N)+M) / 返回分?jǐn)?shù)在指定范圍內(nèi)的成員列表。
  該命令將返回分?jǐn)?shù)在min和max之間的所有成員，即滿足表達(dá)式min <= score <= max的成員，其中返回的成員是按照其分?jǐn)?shù)從低到高的順序返回，如果成員具有相同的分?jǐn)?shù)，則按成員的字典順序返回?？蛇x參數(shù)LIMIT用于限制返回成員的數(shù)量范圍?？蛇x參數(shù)offset表示從符合條件的第offset個(gè)成員開始返回，同時(shí)返回count個(gè)成員?？蛇x參數(shù)WITHSCORES的含義參照ZRANGE中該選項(xiàng)的說明。最后需要說明的是參數(shù)中min和max的規(guī)則可參照命令ZCOUNT。

• ZRANK key member O(log(N)) 時(shí)間復(fù)雜度中的N表示Sorted-Set中成員的數(shù)量。/ 如果該成員存在，則返回它的位置索引值。否則返回nil。
  Sorted-Set中的成員都是按照分?jǐn)?shù)從低到高的順序存儲(chǔ)，該命令將返回參數(shù)中指定成員的位置值，其中0表示第一個(gè)成員，它是Sorted-Set中分?jǐn)?shù)最低的成員。

• ZREM key member [member ...] O(M log(N))時(shí)間復(fù)雜度中N表示Sorted-Set中成員的數(shù)量，M則表示被刪除的成員數(shù)量。/實(shí)際被刪除的成員數(shù)量。
  該命令將移除參數(shù)中指定的成員，其中不存在的成員將被忽略。如果與該Key關(guān)聯(lián)的Value不是Sorted-Set，相應(yīng)的錯(cuò)誤信息將被返回。

• ZREVRANGE key start stop [WITHSCORES] O(log(N)+M) 時(shí)間復(fù)雜度中的N表示Sorted-Set中成員的數(shù)量，M則表示返回的成員數(shù)量。/ 返回指定的成員列表。
  該命令的功能和ZRANGE基本相同，唯一的差別在于該命令是通過反向排序獲取指定位置的成員，即從高到低的順序。如果成員具有相同的分?jǐn)?shù)，則按降序字典順序排序。

• ZREVRANK key member O(log(N)) 時(shí)間復(fù)雜度中的N表示Sorted-Set中成員的數(shù)量。/ 如果該成員存在，則返回它的位置索引值。否則返回nil。
  該命令的功能和ZRANK基本相同，唯一的差別在于該命令獲取的索引是從高到低排序后的位置，同樣0表示第一個(gè)元素，即分?jǐn)?shù)最高的成員。

• ZSCORE key member O(1) 獲取指定Key的指定成員的分?jǐn)?shù)。 如果該成員存在，以字符串的形式返回其分?jǐn)?shù)，否則返回nil。

• ZREVRANGEBYSCORE key max min [WITHSCORES] [LIMIT offset count] O(log(N)+M) 時(shí)間復(fù)雜度中的N表示Sorted-Set中成員的數(shù)量，M則表示返回的成員數(shù)量。/ 返回分?jǐn)?shù)在指定范圍內(nèi)的成員列表。
  該命令除了排序方式是基于從高到低的分?jǐn)?shù)排序之外，其它功能和參數(shù)含義均與>* ZRANGEBYSCORE相同。

• ZREMRANGEBYRANK key start stop O(log(N)+M)時(shí)間復(fù)雜度中的N表示Sorted-Set中成員的數(shù)量，M則表示被刪除的成員數(shù)量。/ 被刪除的成員數(shù)量。
  刪除索引位置位于start和stop之間的成員，start和stop都是0-based，即0表示分?jǐn)?shù)最低的成員，-1表示最后一個(gè)成員，即分?jǐn)?shù)最高的成員。

• ZREMRANGEBYSCORE key min max O(log(N)+M) 時(shí)間復(fù)雜度中的N表示Sorted-Set中成員的數(shù)量，M則表示被刪除的成員數(shù)量。/ 被刪除的成員數(shù)量。
  刪除分?jǐn)?shù)在min和max之間的所有成員，即滿足表達(dá)式min <= score <= max的所有成員。對(duì)于min和max參數(shù)，可以采用開區(qū)間的方式表示，具體規(guī)則參照ZCOUNT。

• 使用場景: 1. 根據(jù)時(shí)間順序產(chǎn)生的數(shù)據(jù)存儲(chǔ)

文章內(nèi)容整理自學(xué)習(xí)資料和網(wǎng)絡(luò), 侵刪.
點(diǎn)擊參看更多sortedset命令