Redis筆記7：數(shù)據(jù)類型之有序集合(sorted set)

2024-07-21 02:51:22

字體：大中小

供稿：網(wǎng)友

命令描述例子ZADD 添加排序成員 ZADD key score member [score] [member]ZCARD 獲取成員數(shù)量 ZCARD keyZCOUNT 獲取分?jǐn)?shù)在min和max之間成員有多少個 ZCOUNT key min maxZINCRBY 增加指定成員的分?jǐn)?shù) ZINCRBY key increment memberZRANGE 遍歷成員以及分?jǐn)?shù) ZRANGE key start stop [WITHSCORES]ZRANGEBYSCORE 返回分?jǐn)?shù)在min和max之間的成員和分?jǐn)?shù) ZRANGEBYSCORE key min max [WITHSCORES]ZRANK 返回成員的下標(biāo) ZRANK key memberZREM 刪除指定成員 ZREM key member [member ...]ZREVRANGE 遍歷成員以及分?jǐn)?shù)從大到小 ZREVRANGE key start stop [WITHSCORES]ZREVRANK 返回成員下標(biāo)順序從大到小 ZREVRANK key memberZSCORE 獲取指定成員的分?jǐn)?shù) ZSCORE key memberZREVRANGEBYSCORE 獲取成員以及分?jǐn)?shù)按照從高到低 ZREVRANGEBYSCORE key max min [WITHSCORES]ZREMRANGEBYRANK 刪除下標(biāo)之間的數(shù)據(jù) ZREMRANGEBYRANK key start stopZREMRANGEBYSCORE 刪除分?jǐn)?shù)在min和max中的成員 ZREMRANGEBYSCORE key min max

1、ZADD key score member [[score member] [score member] …]

將一個或多個 member 元素及其 score 值加入到有序集 key 當(dāng)中。 如果某個 member 已經(jīng)是有序集的成員，那么更新這個 member 的 score 值，并通過重新插入這個 member元素，來保證該 member 在正確的位置上。 score 值可以是整數(shù)值或雙精度浮點數(shù)。如果 key 不存在，則創(chuàng)建一個空的有序集并執(zhí)行ZADD 操作。當(dāng) key 存在但不是有序集類型時，返回一個錯誤。 返回值: 被成功添加的新成員的數(shù)量，不包括那些被更新的、已經(jīng)存在的成員。 示例：

127.0.0.1:6379[15]> ZADD page_rank 10 google.com # 添加單個元素(integer) 1127.0.0.1:6379[15]> ZADD page_rank 9 baidu.com 8 bing.com # 添加多個元素(integer) 2127.0.0.1:6379[15]> ZRANGE page_rank 0 -1 WITHSCORES1) "bing.com"2) "8"3) "baidu.com"4) "9"5) "google.com"6) "10"127.0.0.1:6379[15]> ZADD page_rank 10 google.com # 添加已存在元素(integer) 0127.0.0.1:6379[15]> ZRANGE page_rank 0 -1 WITHSCORES 1) "bing.com"2) "8"3) "baidu.com"4) "9"5) "google.com"6) "10"127.0.0.1:6379[15]> ZADD page_rank 6 bing.com # 添加已存在元素，但是改變 score 值(integer) 0127.0.0.1:6379[15]> ZRANGE page_rank 0 -1 WITHSCORES1) "bing.com"2) "6"3) "baidu.com"4) "9"5) "google.com"6) "10"

2、ZCARD key

返回有序集 key 的基數(shù)。 返回值: 當(dāng) key 存在且是有序集類型時，返回有序集的基數(shù)。當(dāng) key 不存在時，返回 0 。 示例：

127.0.0.1:6379[15]> ZADD salary 2000 tom(integer) 1127.0.0.1:6379[15]> ZCARD salary(integer) 1127.0.0.1:6379[15]> ZADD salary 5000 jack (integer) 1127.0.0.1:6379[15]> ZCARD salary(integer) 2127.0.0.1:6379[15]> EXISTS non_exists_key (integer) 0127.0.0.1:6379[15]> ZCARD non_exists_key(integer) 0

3、ZCOUNT key min max

返回有序集 key 中，score 值在 min 和 max 之間 (默認(rèn)包括 score 值等于 min 或 max ) 的成員的數(shù)量。 **返回值: **score 值在 min 和 max 之間的成員的數(shù)量。 示例：

127.0.0.1:6379[15]> ZADD salary 2000 tom 3500 peter 5000 jack (integer) 2127.0.0.1:6379[15]> ZRANGE salary 0 -1 WITHSCORES1) "tom"2) "2000"3) "peter"4) "3500"5) "jack"6) "5000"127.0.0.1:6379[15]> ZCOUNT salary 2000 5000(integer) 3127.0.0.1:6379[15]> ZCOUNT salary 3000 5000(integer) 2

4、ZINCRBY key increment member

為有序集 key 的成員 member 的 score 值加上增量 increment 。 可以通過傳遞一個負(fù)數(shù)值 increment ，讓 score 減去相應(yīng)的值，比如 ZINCRBY key -5 member，就是讓member的 score 值減去 5 。當(dāng) key 不存在，或 member 不是 key 的成員時，ZINCRBY key increment member 等同于 ZADD key increment member 。當(dāng) key 不是有序集類型時，返回一個錯誤。 score 值可以是整數(shù)值或雙精度浮點數(shù)。 返回值: member 成員的新 score 值，以字符串形式表示。 示例：

127.0.0.1:6379[15]> ZADD salary 2000 tom 3500 peter 5000 jack(integer) 3127.0.0.1:6379[15]> ZSCORE salary tom"2000"127.0.0.1:6379[15]> ZINCRBY salary 2000 tom"4000"127.0.0.1:6379[15]> ZSCORE salary tom"4000"

5、ZRANGE key start stop [WITHSCORES]

返回有序集 key 中，指定區(qū)間內(nèi)的成員。 返回值: 指定區(qū)間內(nèi)，帶有 score 值 (可選) 的有序集成員的列表。 示例：

127.0.0.1:6379[15]> ZADD salary 3500 jack 5000 tom 10086 boss(integer) 3127.0.0.1:6379[15]> ZRANGE salary 1 2 WITHSCORES1) "tom"2) "5000"3) "boss"4) "10086"127.0.0.1:6379[15]> ZRANGE salary 0 200000 WITHSCORES 1) "jack"2) "3500"3) "tom"4) "5000"5) "boss"6) "10086"127.0.0.1:6379[15]> ZRANGE salary 0 -1 WITHSCORES 1) "jack"2) "3500"3) "tom"4) "5000"5) "boss"6) "10086"127.0.0.1:6379[15]> ZRANGE salary 200000 3000000 WITHSCORES(empty list or set)

6、ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT offset count]

返回有序集 key 中，所有 score 值介于 min 和 max 之間 (包括等于 min 或 max ) 的成員。有序集成員按score 值遞增 (從小到大) 次序排列。 返回值: 指定區(qū)間內(nèi)，帶有 score 值 (可選) 的有序集成員的列表。 示例：

127.0.0.1:6379[15]> ZADD salary 2500 jack (integer) 1127.0.0.1:6379[15]> ZADD salary 5000 tom(integer) 1127.0.0.1:6379[15]> ZADD salary 12000 peter(integer) 1127.0.0.1:6379[15]> ZRANGEBYSCORE salary -inf +inf 1) "jack"2) "tom"3) "peter"127.0.0.1:6379[15]> ZRANGEBYSCORE salary -inf +inf WITHSCORES1) "jack"2) "2500"3) "tom"4) "5000"5) "peter"6) "12000"127.0.0.1:6379[15]> ZRANGEBYSCORE salary -inf 5000 WITHSCORES 1) "jack"2) "2500"3) "tom"4) "5000"127.0.0.1:6379[15]> ZRANGEBYSCORE salary (5000 400000 1) "peter"

7、ZRANK key member

返回有序集 key 中成員 member 的排名。其中有序集成員按 score 值遞增 (從小到大) 順序排列。排名以 0 為底，也就是說，score 值最小的成員排名為 0 。使用ZREVRANK 命令可以獲得成員按 score 值遞減 (從大到小) 排列的排名。 返回值: 如果 member 是有序集 key 的成員，返回 member 的排名。如果 member 不是有序集 key 的成員，返回 nil 。 示例：

127.0.0.1:6379[15]> ZRANGE salary 0 -1 WITHSCORES1) "tom"2) "2000"3) "peter"4) "3500"5) "jack"6) "5000"127.0.0.1:6379[15]> ZRANK salary tom(integer) 0

8、ZREM key member [member …]

移除有序集 key 中的一個或多個成員，不存在的成員將被忽略。 當(dāng) key 存在但不是有序集類型時，返回一個錯誤。 返回值: 被成功移除的成員的數(shù)量，不包括被忽略的成員。 示例：

127.0.0.1:6379[15]> ZRANGE page_rank 0 -1 WITHSCORES1) "bing.com"2) "6"3) "baidu.com"4) "9"5) "google.com"6) "10" 127.0.0.1:6379[15]> ZREM page_rank google.com # 移除單個元素(integer) 1127.0.0.1:6379[15]> ZRANGE page_rank 0 -1 WITHSCORES1) "bing.com"2) "6"3) "baidu.com"4) "9"127.0.0.1:6379[15]> ZREM page_rank baidu.com bing.com # 移除多個元素(integer) 2127.0.0.1:6379[15]> ZRANGE page_rank 0 -1 WITHSCORES(empty list or set)127.0.0.1:6379[15]> ZREM page_rank non-exists-element # 移除不存在的元素(integer) 0

9、ZREVRANGE key start stop [WITHSCORES]

返回有序集 key 中，指定區(qū)間內(nèi)的成員。 其中成員的位置按 score 值遞減 (從大到小) 來排列。具有相同 score 值的成員按字典序的逆序 (reverse lexicographical order) 排列。除了成員按 score 值遞減的次序排列這一點外，ZREVRANGE 命令的其他方面和ZRANGE 命令一樣。 返回值： 指定區(qū)間內(nèi)，帶有分?jǐn)?shù)值(可選)的有序集成員的列表。 示例：

127.0.0.1:6379[15]> ZRANGE salary 0 -1 WITHSCORES 1) "tom"2) "2000"3) "peter"4) "3500"5) "jack"6) "5000"127.0.0.1:6379[15]> ZREVRANGE salary 0 -1 WITHSCORES1) "jack"2) "5000"3) "peter"4) "3500"5) "tom"6) "2000"

10、ZREVRANK key member

返回有序集 key 中成員 member 的排名。其中有序集成員按 score 值遞減 (從大到小) 排序。排名以 0 為底，也就是說，score 值最大的成員排名為 0 。使用ZRANK 命令可以獲得成員按 score 值遞增 (從小到大) 排列的排名。 返回值: 如果 member 是有序集 key 的成員，返回 member 的排名。如果 member 不是有序集 key 的成員，返回 nil 。 示例：

127.0.0.1:6379[15]> ZRANGE salary 0 -1 WITHSCORES1) "jack"2) "3500"3) "tom"4) "5000"5) "boss"6) "10086"127.0.0.1:6379[15]> ZREVRANK salary tom(integer) 1127.0.0.1:6379[15]> ZREVRANK salary boss(integer) 0

11、ZSCORE key member

返回有序集 key 中，成員 member 的 score 值。 如果 member 元素不是有序集 key 的成員，或 key 不存在，返回 nil 。 **返回值: **member 成員的 score 值，以字符串形式表示。 示例：

127.0.0.1:6379[15]> ZADD salary 2000 tom 3500 peter 5000 jack(integer) 3127.0.0.1:6379[15]> ZSCORE salary peter"3500"

12、ZREVRANGEBYSCORE key max min [WITHSCORES] [LIMIT offset count]

返回有序集 key 中，score 值介于 max 和 min 之間 (默認(rèn)包括等于 max 或 min ) 的所有的成員。有序集成員按 score 值遞減 (從大到小) 的次序排列。 返回值: 指定區(qū)間內(nèi)，帶有 score 值 (可選) 的有序集成員的列表。 示例：

127.0.0.1:6379[15]> ZADD salary 10086 jack 5000 tom 7000 peter 3500 joe(integer) 4127.0.0.1:6379[15]> ZREVRANGEBYSCORE salary +inf -inf1) "jack"2) "peter"3) "tom"4) "joe"127.0.0.1:6379[15]> ZREVRANGEBYSCORE salary +inf -inf1) "jack"2) "peter"3) "tom"4) "joe"127.0.0.1:6379[15]> ZREVRANGEBYSCORE salary 10000 20001) "peter"2) "tom"3) "joe"

13、ZREMRANGEBYRANK key start stop

移除有序集 key 中，指定排名 (rank) 區(qū)間內(nèi)的所有成員。 區(qū)間分別以下標(biāo)參數(shù) start 和 stop 指出，包含 start 和 stop 在內(nèi)。下標(biāo)參數(shù) start 和 stop 都以 0 為底，也就是說，以 0 表示有序集第一個成員，以 1 表示有序集第二個成員，以此類推。你也可以使用負(fù)數(shù)下標(biāo)，以 -1 表示最后一個成員，-2 表示倒數(shù)第二個成員，以此類推。 返回值: 被移除成員的數(shù)量。 示例：

127.0.0.1:6379[15]> ZADD salary 2000 jack(integer) 1127.0.0.1:6379[15]> ZADD salary 5000 tom(integer) 1127.0.0.1:6379[15]> ZADD salary 3500 peter(integer) 1127.0.0.1:6379[15]> ZREMRANGEBYRANK salary 0 1 (integer) 2127.0.0.1:6379[15]> ZRANGE salary 0 -1 WITHSCORES1) "tom"2) "5000"

14、ZREMRANGEBYSCORE key min max

移除有序集 key 中，所有 score 值介于 min 和 max 之間 (包括等于 min 或 max ) 的成員。 自版本 2.1.6 開始，score 值等于 min 或 max 的成員也可以不包括在內(nèi)。 返回值: 被移除成員的數(shù)量。 示例：

127.0.0.1:6379[15]> ZADD salary 2000 tom 3500 peter 5000 jack (integer) 3127.0.0.1:6379[15]> ZRANGE salary 0 -1 WITHSCORES1) "tom"2) "2000"3) "peter"4) "3500"5) "jack"6) "5000"127.0.0.1:6379[15]> ZREMRANGEBYSCORE salary 1500 3500(integer) 2127.0.0.1:6379[15]> ZRANGE salary 0 -1 WITHSCORES1) "jack"2) "5000"

（結(jié)束）

參考：http://blog.csdn.net/thinkercode/article/details/46575813

上一篇：Redis筆記6：數(shù)據(jù)類型之哈希(Hash)

下一篇：Redis筆記8：解析配置文件redis.conf