命令原型 | 時間復雜度 | 命令描述 | 返回值 |
ZADD key score member [score] [member] | O(log(N)) | 時間復雜度中的N表示Sorted-Sets中成員的數量。添加參數中指定的所有成員及其分數到指定key的Sorted-Set中,在該命令中我們可以指定多組score/member作為參數。如果在添加時參數中的某一成員已經存在,該命令將更新此成員的分數為新值,同時再將該成員基于新值重新排序。如果鍵不存在,該命令將為該鍵創建一個新的Sorted-Sets Value,并將score/member對插入其中。如果該鍵已經存在,但是與其關聯的Value不是Sorted-Sets類型,相關的錯誤信息將被返回。 | 本次操作實際插入的成員數量。 |
ZCARD key | O(1) | 獲取與該Key相關聯的Sorted-Sets中包含的成員數量。 | 返回Sorted-Sets中的成員數量,如果該Key不存在,返回0。 |
ZCOUNTkey min max | O(log(N)+M) | 時間復雜度中的N表示Sorted-Sets中成員的數量,M則表示min和max之間元素的數量。該命令用于獲取分數(score)在min和max之間的成員數量。針對min和max參數需要額外說明的是,-inf和+inf分別表示Sorted-Sets中分數的最高值和最低值。缺省情況下,min和max表示的范圍是閉區間范圍,即min = score = max內的成員將被返回。然而我們可以通過在min和max的前面添加"("字符來表示開區間,如(min max表示min score = max,而(min (max表示min score max。 | 分數指定范圍內成員的數量。 |
ZINCRBYkey increment member | O(log(N)) | 時間復雜度中的N表示Sorted-Sets中成員的數量。該命令將為指定Key中的指定成員增加指定的分數。如果成員不存在,該命令將添加該成員并假設其初始分數為0,此后再將其分數加上increment。如果Key不存,該命令將創建該Key及其關聯的Sorted-Sets,并包含參數指定的成員,其分數為increment參數。如果與該Key關聯的不是Sorted-Sets類型,相關的錯誤信息將被返回。 | 以字符串形式表示的新分數。 |
ZRANGEkey start stop [WITHSCORES] | O(log(N)+M) | 時間復雜度中的N表示Sorted-Set中成員的數量,M則表示返回的成員數量。該命令返回順序在參數start和stop指定范圍內的成員,這里start和stop參數都是0-based,即0表示第一個成員,-1表示最后一個成員。如果start大于該Sorted-Set中的最大索引值,或start > stop,此時一個空集合將被返回。如果stop大于最大索引值,該命令將返回從start到集合的最后一個成員。如果命令中帶有可選參數WITHSCORES選項,該命令在返回的結果中將包含每個成員的分數值,如value1,score1,value2,score2...。 | 返回索引在start和stop之間的成員列表。 |
ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT offset count] | O(log(N)+M) | 時間復雜度中的N表示Sorted-Set中成員的數量,M則表示返回的成員數量。該命令將返回分數在min和max之間的所有成員,即滿足表達式min = score = max的成員,其中返回的成員是按照其分數從低到高的順序返回,如果成員具有相同的分數,則按成員的字典順序返回。可選參數LIMIT用于限制返回成員的數量范圍。可選參數offset表示從符合條件的第offset個成員開始返回,同時返回count個成員。可選參數WITHSCORES的含義參照ZRANGE中該選項的說明。最后需要說明的是參數中min和max的規則可參照命令ZCOUNT。 | 返回分數在指定范圍內的成員列表。 |
ZRANK key member | O(log(N)) | 時間復雜度中的N表示Sorted-Set中成員的數量。Sorted-Set中的成員都是按照分數從低到高的順序存儲,該命令將返回參數中指定成員的位置值,其中0表示第一個成員,它是Sorted-Set中分數最低的成員。 | 如果該成員存在,則返回它的位置索引值。否則返回nil。 |
ZREM key member [member ...] | O(M log(N)) | 時間復雜度中N表示Sorted-Set中成員的數量,M則表示被刪除的成員數量。該命令將移除參數中指定的成員,其中不存在的成員將被忽略。如果與該Key關聯的Value不是Sorted-Set,相應的錯誤信息將被返回。 | 實際被刪除的成員數量。 |
ZREVRANGE key startstop[WITHSCORES] | O(log(N)+M) | 時間復雜度中的N表示Sorted-Set中成員的數量,M則表示返回的成員數量。該命令的功能和ZRANGE基本相同,唯一的差別在于該命令是通過反向排序獲取指定位置的成員,即從高到低的順序。如果成員具有相同的分數,則按降序字典順序排序。 | 返回指定的成員列表。 |
ZREVRANKkey member | O(log(N)) | 時間復雜度中的N表示Sorted-Set中成員的數量。該命令的功能和ZRANK基本相同,唯一的差別在于該命令獲取的索引是從高到低排序后的位置,同樣0表示第一個元素,即分數最高的成員。 | 如果該成員存在,則返回它的位置索引值。否則返回nil。 |
ZSCOREkey member | O(1) | 獲取指定Key的指定成員的分數。 | 如果該成員存在,以字符串的形式返回其分數,否則返回nil。 |
ZREVRANGEBYSCOREkey max min [WITHSCORES] [LIMIT offset count] | O(log(N)+M) | 時間復雜度中的N表示Sorted-Set中成員的數量,M則表示返回的成員數量。該命令除了排序方式是基于從高到低的分數排序之外,其它功能和參數含義均與ZRANGEBYSCORE相同。 | 返回分數在指定范圍內的成員列表。 |
ZREMRANGEBYRANKkey start stop | O(log(N)+M) | 時間復雜度中的N表示Sorted-Set中成員的數量,M則表示被刪除的成員數量。刪除索引位置位于start和stop之間的成員,start和stop都是0-based,即0表示分數最低的成員,-1表示最后一個成員,即分數最高的成員。 | 被刪除的成員數量。 |
ZREMRANGEBYSCOREkey min max | O(log(N)+M) | 時間復雜度中的N表示Sorted-Set中成員的數量,M則表示被刪除的成員數量。刪除分數在min和max之間的所有成員,即滿足表達式min = score = max的所有成員。對于min和max參數,可以采用開區間的方式表示,具體規則參照ZCOUNT。 | 被刪除的成員數量。 |
三、命令示例:
1. ZADD/ZCARD/ZCOUNT/ZREM/ZINCRBY/ZSCORE/ZRANGE/ZRANK:
1). 可以用于一個大型在線游戲的積分排行榜。每當玩家的分數發生變化時,可以執行ZADD命令更新玩家的分數,此后再通過ZRANGE命令獲取積分TOP TEN的用戶信息。當然我們也可以利用ZRANK命令通過username來獲取玩家的排行信息。最后我們將組合使用ZRANGE和ZRANK命令快速的獲取和某個玩家積分相近的其他用戶的信息。
2). Sorted-Sets類型還可用于構建索引數據。