命令原型 | 時(shí)間復(fù)雜度 | 命令描述 | 返回值 |
ZADD key score member [score] [member] | O(log(N)) | 時(shí)間復(fù)雜度中的N表示Sorted-Sets中成員的數(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ò)誤信息將被返回。 | 本次操作實(shí)際插入的成員數(shù)量。 |
ZCARD key | O(1) | 獲取與該Key相關(guān)聯(lián)的Sorted-Sets中包含的成員數(shù)量。 | 返回Sorted-Sets中的成員數(shù)量,如果該Key不存在,返回0。 |
ZCOUNTkey min max | O(log(N)+M) | 時(shí)間復(fù)雜度中的N表示Sorted-Sets中成員的數(shù)量,M則表示min和max之間元素的數(shù)量。該命令用于獲取分?jǐn)?shù)(score)在min和max之間的成員數(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。 | 分?jǐn)?shù)指定范圍內(nèi)成員的數(shù)量。 |
ZINCRBYkey increment member | O(log(N)) | 時(shí)間復(fù)雜度中的N表示Sorted-Sets中成員的數(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ò)誤信息將被返回。 | 以字符串形式表示的新分?jǐn)?shù)。 |
ZRANGEkey start stop [WITHSCORES] | O(log(N)+M) | 時(shí)間復(fù)雜度中的N表示Sorted-Set中成員的數(shù)量,M則表示返回的成員數(shù)量。該命令返回順序在參數(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...。 | 返回索引在start和stop之間的成員列表。 |
ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT offset count] | O(log(N)+M) | 時(shí)間復(fù)雜度中的N表示Sorted-Set中成員的數(shù)量,M則表示返回的成員數(shù)量。該命令將返回分?jǐn)?shù)在min和max之間的所有成員,即滿足表達(dá)式min = score = max的成員,其中返回的成員是按照其分?jǐn)?shù)從低到高的順序返回,如果成員具有相同的分?jǐn)?shù),則按成員的字典順序返回。可選參數(shù)LIMIT用于限制返回成員的數(shù)量范圍??蛇x參數(shù)offset表示從符合條件的第offset個(gè)成員開始返回,同時(shí)返回count個(gè)成員。可選參數(shù)WITHSCORES的含義參照ZRANGE中該選項(xiàng)的說明。最后需要說明的是參數(shù)中min和max的規(guī)則可參照命令ZCOUNT。 | 返回分?jǐn)?shù)在指定范圍內(nèi)的成員列表。 |
ZRANK key member | O(log(N)) | 時(shí)間復(fù)雜度中的N表示Sorted-Set中成員的數(shù)量。Sorted-Set中的成員都是按照分?jǐn)?shù)從低到高的順序存儲(chǔ),該命令將返回參數(shù)中指定成員的位置值,其中0表示第一個(gè)成員,它是Sorted-Set中分?jǐn)?shù)最低的成員。 | 如果該成員存在,則返回它的位置索引值。否則返回nil。 |
ZREM key member [member ...] | O(M log(N)) | 時(shí)間復(fù)雜度中N表示Sorted-Set中成員的數(shù)量,M則表示被刪除的成員數(shù)量。該命令將移除參數(shù)中指定的成員,其中不存在的成員將被忽略。如果與該Key關(guān)聯(lián)的Value不是Sorted-Set,相應(yīng)的錯(cuò)誤信息將被返回。 | 實(shí)際被刪除的成員數(shù)量。 |
ZREVRANGE key startstop[WITHSCORES] | O(log(N)+M) | 時(shí)間復(fù)雜度中的N表示Sorted-Set中成員的數(shù)量,M則表示返回的成員數(shù)量。該命令的功能和ZRANGE基本相同,唯一的差別在于該命令是通過反向排序獲取指定位置的成員,即從高到低的順序。如果成員具有相同的分?jǐn)?shù),則按降序字典順序排序。 | 返回指定的成員列表。 |
ZREVRANKkey member | O(log(N)) | 時(shí)間復(fù)雜度中的N表示Sorted-Set中成員的數(shù)量。該命令的功能和ZRANK基本相同,唯一的差別在于該命令獲取的索引是從高到低排序后的位置,同樣0表示第一個(gè)元素,即分?jǐn)?shù)最高的成員。 | 如果該成員存在,則返回它的位置索引值。否則返回nil。 |
ZSCOREkey member | O(1) | 獲取指定Key的指定成員的分?jǐn)?shù)。 | 如果該成員存在,以字符串的形式返回其分?jǐn)?shù),否則返回nil。 |
ZREVRANGEBYSCOREkey max min [WITHSCORES] [LIMIT offset count] | O(log(N)+M) | 時(shí)間復(fù)雜度中的N表示Sorted-Set中成員的數(shù)量,M則表示返回的成員數(shù)量。該命令除了排序方式是基于從高到低的分?jǐn)?shù)排序之外,其它功能和參數(shù)含義均與ZRANGEBYSCORE相同。 | 返回分?jǐn)?shù)在指定范圍內(nèi)的成員列表。 |
ZREMRANGEBYRANKkey start stop | O(log(N)+M) | 時(shí)間復(fù)雜度中的N表示Sorted-Set中成員的數(shù)量,M則表示被刪除的成員數(shù)量。刪除索引位置位于start和stop之間的成員,start和stop都是0-based,即0表示分?jǐn)?shù)最低的成員,-1表示最后一個(gè)成員,即分?jǐn)?shù)最高的成員。 | 被刪除的成員數(shù)量。 |
ZREMRANGEBYSCOREkey min max | O(log(N)+M) | 時(shí)間復(fù)雜度中的N表示Sorted-Set中成員的數(shù)量,M則表示被刪除的成員數(shù)量。刪除分?jǐn)?shù)在min和max之間的所有成員,即滿足表達(dá)式min = score = max的所有成員。對(duì)于min和max參數(shù),可以采用開區(qū)間的方式表示,具體規(guī)則參照ZCOUNT。 | 被刪除的成員數(shù)量。 |
三、命令示例:
1. ZADD/ZCARD/ZCOUNT/ZREM/ZINCRBY/ZSCORE/ZRANGE/ZRANK:
1). 可以用于一個(gè)大型在線游戲的積分排行榜。每當(dāng)玩家的分?jǐn)?shù)發(fā)生變化時(shí),可以執(zhí)行ZADD命令更新玩家的分?jǐn)?shù),此后再通過ZRANGE命令獲取積分TOP TEN的用戶信息。當(dāng)然我們也可以利用ZRANK命令通過username來獲取玩家的排行信息。最后我們將組合使用ZRANGE和ZRANK命令快速的獲取和某個(gè)玩家積分相近的其他用戶的信息。
2). Sorted-Sets類型還可用于構(gòu)建索引數(shù)據(jù)。
標(biāo)簽:葫蘆島 保定 昆明 沈陽 石嘴山 常德 鶴崗 招商
巨人網(wǎng)絡(luò)通訊聲明:本文標(biāo)題《Redis教程(六):Sorted-Sets數(shù)據(jù)類型》,本文關(guān)鍵詞 Redis,教程,六,Sorted-Sets,數(shù)據(jù),;如發(fā)現(xiàn)本文內(nèi)容存在版權(quán)問題,煩請(qǐng)?zhí)峁┫嚓P(guān)信息告之我們,我們將及時(shí)溝通與處理。本站內(nèi)容系統(tǒng)采集于網(wǎng)絡(luò),涉及言論、版權(quán)與本站無關(guān)。