Redis的Zset類型及相關(guān)命令詳細講解
Zset簡介
有序集合相對于字符串、列表、哈希、集合來說會有?些陌?。它保留了集合不能有重復(fù)成員的特點，但與集合不同的是，有序集合中的每個元素都有?個唯?的浮點類型的分數(shù)（score）與之關(guān)聯(lián)，著使得有序集合中的元素是可以維護有序性的，但這個有序不是?下標作為排序依據(jù)?是?這個分數(shù)。
ZADD
添加或者更新指定的元素以及關(guān)聯(lián)的分數(shù)到 zset 中，分數(shù)應(yīng)該符合 double 類型，+inf/-inf 作為正負極限也是合法的。
語法
ZADD key [NX | XX] [GT | LT] [CH] [INCR] score member [score member ...]
ZADD 的相關(guān)選項：
• XX：僅僅?于更新已經(jīng)存在的元素，不會添加新元素。
• NX：僅?于添加新元素，不會更新已經(jīng)存在的元素。
• CH：默認情況下，ZADD 返回的是本次添加的元素個數(shù)，但指定這個選項之后，就會還包含本次更新的元素的個數(shù)。
• INCR：此時命令類似 ZINCRBY 的效果，將元素的分數(shù)加上指定的分數(shù)。此時只能指定?個元素和分數(shù)。
時間復(fù)雜度：O(log(N))
返回值：本次添加成功的元素個數(shù)。
舉例
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"
ZCARD
獲取?個 zset 的基數(shù)（cardinality），即 zset 中的元素個數(shù)。
語法
ZCARD key
時間復(fù)雜度：O(1)
返回值：zset 內(nèi)的元素個數(shù)。
舉例
redis> ZADD myzset 1 "one" (integer) 1 redis> ZADD myzset 2 "two" (integer) 1 redis> ZCARD myzset (integer) 2
ZCOUNT
返回分數(shù)在 min 和 max 之間的元素個數(shù)，默認情況下，min 和 max 都是包含的，可以通過 ( 排除。
語法
ZCOUNT key min max
時間復(fù)雜度：O(log(N))
返回值：滿?條件的元素列表個數(shù)。
舉例
redis> ZADD myzset 1 "one" (integer) 1 redis> ZADD myzset 2 "two" (integer) 1 redis> ZADD myzset 3 "three" (integer) 1 redis> ZCOUNT myzset -inf +inf (integer) 3 redis> ZCOUNT myzset (1 3 (integer) 2
ZRANGE
返回指定區(qū)間?的元素，分數(shù)按照升序。帶上 WITHSCORES 可以把分數(shù)也返回。
語法
ZRANGE key start stop [WITHSCORES]
時間復(fù)雜度：O(log(N)+M)
返回值：區(qū)間內(nèi)的元素列表。
舉例
redis> ZADD myzset 1 "one" 2 "two" 3 "three" (integer) 3 redis> ZRANGE myzset 0 -1 1) "one" 2) "two" 3) "three" redis> ZRANGE myzset 2 3 1) "three" redis> ZRANGE myzset -2 -1 1) "two" 2) "three"
ZREVRANGE
返回指定區(qū)間?的元素，分數(shù)按照降序。帶上 WITHSCORES 可以把分數(shù)也返回。
語法
ZREVRANGE key start stop [WITHSCORES]
時間復(fù)雜度：O(log(N)+M)
返回值：區(qū)間內(nèi)的元素列表。
舉例
redis> ZADD myzset 1 "one" (integer) 1 redis> ZADD myzset 2 "two" (integer) 1 redis> ZADD myzset 3 "three" (integer) 1 redis> ZREVRANGE myzset 0 -1 1) "three" 2) "two" 3) "one" redis> ZREVRANGE myzset 2 3 1) "one" redis> ZREVRANGE myzset -2 -1 1) "two" 2) "one"
ZRANGEBYSCORE
返回分數(shù)在 min 和 max 之間的元素，默認情況下，min 和 max 都是包含的，可以通過 ( 排除。
語法
ZRANGEBYSCORE key min max [WITHSCORES]
時間復(fù)雜度：O(log(N)+M)
返回值：區(qū)間內(nèi)的元素列表。
舉例
redis> ZADD myzset 1 "one" (integer) 1 redis> ZADD myzset 2 "two" (integer) 1 redis> ZADD myzset 3 "three" (integer) 1 redis> ZRANGEBYSCORE myzset -inf +inf 1) "one" 2) "two" 3) "three" redis> ZRANGEBYSCORE myzset 1 2 1) "one" 2) "two" redis> ZRANGEBYSCORE myzset (1 2 1) "two" redis> ZRANGEBYSCORE myzset (1 (2 (empty array)
ZPOPMAX
刪除并返回分數(shù)最?的 count 個元素。
語法
ZPOPMAX key [count]
時間復(fù)雜度：O(log(N) * M)
返回值：分數(shù)和元素列表。
舉例
redis> ZADD myzset 1 "one" (integer) 1 redis> ZADD myzset 2 "two" (integer) 1 redis> ZADD myzset 3 "three" (integer) 1 redis> ZPOPMAX myzset 1) "three" 2) "3"
BZPOPMAX
ZPOPMAX 的阻塞版本。
語法
BZPOPMAX key [key ...] timeout
時間復(fù)雜度：O(log(N))
返回值：元素列表。
舉例
redis> DEL zset1 zset2 (integer) 0 redis> ZADD zset1 0 a 1 b 2 c (integer) 3 redis> BZPOPMAX zset1 zset2 0 1) "zset1" 2) "c" 3) "2"
ZPOPMIN
刪除并返回分數(shù)最低的 count 個元素。
語法
ZPOPMIN key [count]
時間復(fù)雜度：O(log(N) * M)
返回值：分數(shù)和元素列表。
舉例
redis> ZADD myzset 1 "one" (integer) 1 redis> ZADD myzset 2 "two" (integer) 1 redis> ZADD myzset 3 "three" (integer) 1 redis> ZPOPMIN myzset 1) "one" 2) "1"
BZPOPMIN
ZPOPMIN 的阻塞版本。
語法
BZPOPMIN key [key ...] timeout
時間復(fù)雜度：O(log(N))
返回值：元素列表。
舉例
redis> DEL zset1 zset2 (integer) 0 redis> ZADD zset1 0 a 1 b 2 c (integer) 3 redis> BZPOPMIN zset1 zset2 0 1) "zset1" 2) "a" 3) "0"
ZRANK
返回指定元素的排名，升序。
語法
ZRANK key member
時間復(fù)雜度：O(log(N))
返回值：排名。
舉例
redis> ZADD myzset 1 "one" (integer) 1 redis> ZADD myzset 2 "two" (integer) 1 redis> ZADD myzset 3 "three" (integer) 1 redis> ZRANK myzset "three" (integer) 2 redis> ZRANK myzset "four" (nil) redis> ZRANK myzset "three" WITHSCORE 1) (integer) 2 2) "3" redis> ZRANK myzset "four" WITHSCORE (nil)
ZREVRANK
返回指定元素的排名，降序。
語法
ZREVRANK key member
時間復(fù)雜度：O(log(N))
返回值：排名。
redis> ZADD myzset 1 "one" (integer) 1 redis> ZADD myzset 2 "two" (integer) 1 redis> ZADD myzset 3 "three" (integer) 1 redis> ZREVRANK myzset "one" (integer) 2 redis> ZREVRANK myzset "four" (nil) redis> ZREVRANK myzset "three" WITHSCORE 1) (integer) 0 2) "3" redis> ZREVRANK myzset "four" WITHSCORE (nil)
ZSCORE
返回指定元素的分數(shù)。
語法
ZSCORE key member
時間復(fù)雜度：O(1)
返回值：分數(shù)。
舉例
redis> ZADD myzset 1 "one" (integer) 1 redis> ZSCORE myzset "one" "1"
ZREM
刪除指定的元素。
語法
ZREM key member [member ...]
時間復(fù)雜度：O(M*log(N))
返回值：本次操作刪除的元素個數(shù)。
舉例
redis> ZADD myzset 1 "one" (integer) 1 redis> ZADD myzset 2 "two" (integer) 1 redis> ZADD myzset 3 "three" (integer) 1 redis> ZREM myzset "two" (integer) 1 redis> ZRANGE myzset 0 -1 WITHSCORES 1) "one" 2) "1" 3) "three" 4) "3"
ZREMRANGEBYRANK
按照排序，升序刪除指定范圍的元素，左閉右閉。
語法
ZREMRANGEBYRANK key start stop
時間復(fù)雜度：O(log(N)+M)
返回值：本次操作刪除的元素個數(shù)。
舉例
redis> ZADD myzset 1 "one" (integer) 1 redis> ZADD myzset 2 "two" (integer) 1 redis> ZADD myzset 3 "three" (integer) 1 redis> ZREMRANGEBYRANK myzset 0 1 (integer) 2 redis> ZRANGE myzset 0 -1 WITHSCORES 1) "three" 2) "3"
ZREMRANGEBYSCORE
按照分數(shù)刪除指定范圍的元素，左閉右閉。
語法
ZREMRANGEBYSCORE key min max
時間復(fù)雜度：O(log(N)+M)
返回值：本次操作刪除的元素個數(shù)。
舉例
redis> ZADD myzset 1 "one" (integer) 1 redis> ZADD myzset 2 "two" (integer) 1 redis> ZADD myzset 3 "three" (integer) 1 redis> ZREMRANGEBYSCORE myzset -inf (2 (integer) 1 redis> ZRANGE myzset 0 -1 WITHSCORES 1) "two" 2) "2" 3) "three" 4) "3"
ZINCRBY
為指定的元素的關(guān)聯(lián)分數(shù)添加指定的分數(shù)值。
語法
ZINCRBY key increment member
時間復(fù)雜度：O(log(N))
返回值：增加后元素的分數(shù)。
舉例
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"
ZINTERSTORE
求出給定有序集合中元素的交集并保存進?標有序集合中，在合并過程中以元素為單位進?合并，元素對應(yīng)的分數(shù)按照不同的聚合?式和權(quán)重得到新的分數(shù)。
語法
ZINTERSTORE destination numkeys key [key ...] [WEIGHTS weight
[weight ...]] [AGGREGATE <SUM | MIN | MAX>]
時間復(fù)雜度：O(N*K)+O(M*log(M)) N 是輸?的有序集合中, 最?的有序集合的元素個數(shù); K 是輸?了?個有序集合; M 是最終結(jié)果的有序集合的元素個數(shù).
返回值：?標集合中的元素個數(shù)。
舉例
redis> ZADD zset1 1 "one" (integer) 1 redis> ZADD zset1 2 "two" (integer) 1 redis> ZADD zset2 1 "one" (integer) 1 redis> ZADD zset2 2 "two" (integer) 1 redis> ZADD zset2 3 "three" (integer) 1 redis> ZINTERSTORE out 2 zset1 zset2 WEIGHTS 2 3 (integer) 2 redis> ZRANGE out 0 -1 WITHSCORES 1) "one" 2) "5" 3) "two" 4) "10"
ZUNIONSTORE
求出給定有序集合中元素的并集并保存進?標有序集合中，在合并過程中以元素為單位進?合并，元素對應(yīng)的分數(shù)按照不同的聚合?式和權(quán)重得到新的分數(shù)。
語法
ZUNIONSTORE destination numkeys key [key ...] [WEIGHTS weight
[weight ...]] [AGGREGATE <SUM | MIN | MAX>]
時間復(fù)雜度：O(N)+O(M*log(M)) N 是輸?的有序集合總的元素個數(shù); M 是最終結(jié)果的有序集合的元素個數(shù).
返回值：?標集合中的元素個數(shù)。
舉例
redis> ZADD zset1 1 "one" (integer) 1 redis> ZADD zset1 2 "two" (integer) 1 redis> ZADD zset2 1 "one" (integer) 1 redis> ZADD zset2 2 "two" (integer) 1 redis> ZADD zset2 3 "three" (integer) 1 redis> ZUNIONSTORE out 2 zset1 zset2 WEIGHTS 2 3 (integer) 3 redis> ZRANGE out 0 -1 WITHSCORES 1) "one" 2) "5" 3) "three" 4) "9" 5) "two" 6) "10"
內(nèi)部編碼
有序集合類型的內(nèi)部編碼有兩種：
• ziplist（壓縮列表）：當有序集合的元素個數(shù)?于 zset-max-ziplist-entries 配置（默認 128 個），同時每個元素的值都?于 zset-max-ziplist-value 配置（默認 64 字節(jié)）時，Redis 會? ziplist 來作為有序集合的內(nèi)部實現(xiàn)，ziplist 可以有效減少內(nèi)存的使?。
• skiplist（跳表）：當 ziplist 條件不滿?時，有序集合會使? skiplist 作為內(nèi)部實現(xiàn)，因為此時ziplist 的操作效率會下降。
1）當元素個數(shù)較少且每個元素較?時，內(nèi)部編碼為 ziplist：
127.0.0.1:6379> zadd zsetkey 50 e1 60 e2 30 e3
(integer) 3
127.0.0.1:6379> object encoding zsetkey
"ziplist"
2）當元素個數(shù)超過 128 個，內(nèi)部編碼 skiplist：
127.0.0.1:6379> zadd zsetkey 50 e1 60 e2 30 e3 ... 省略 ... 82 e129
(integer) 129
127.0.0.1:6379> object encoding zsetkey
"skiplist"
3）當某個元素?于 64 字節(jié)時，內(nèi)部編碼 skiplist：
127.0.0.1:6379> zadd zsetkey 50 "one string bigger than 64 bytes ... 省略 ..."
(integer) 1
127.0.0.1:6379> object encoding zsetkey
"skiplist”
應(yīng)用場景
1.排行榜
Zset非常適合用于實現(xiàn)各種排行榜，如游戲內(nèi)的玩家排名、社交平臺的熱門帖子排名等。
元素可以是玩家的ID或帖子的ID，分數(shù)可以是玩家的積分或帖子的點贊數(shù)、評論數(shù)等。
可以使用ZRANGE或ZREVRANGE命令來獲取排名前列的元素，或使用ZRANK或ZREVRANK命令來獲取特定元素的排名。
2.延時隊列
Zset可以用于實現(xiàn)延時隊列，其中元素代表任務(wù)，分數(shù)代表任務(wù)的執(zhí)行時間戳。
通過定期檢查Zset中分數(shù)最小的元素（即最早應(yīng)該執(zhí)行的任務(wù)），可以實現(xiàn)任務(wù)的定時執(zhí)行。
當任務(wù)執(zhí)行后，可以從Zset中刪除該元素。
總結(jié)
到此這篇關(guān)于Redis的Zset類型及相關(guān)命令的文章就介紹到這了,更多相關(guān)Redis Zset命令詳解內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
Redis數(shù)據(jù)結(jié)構(gòu)-跳躍表skiplist詳解
這篇文章主要介紹了Redis數(shù)據(jù)結(jié)構(gòu)-跳躍表skiplist,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2025-09-09
這篇文章主要介紹了redis5集群如何主動手工切換主從節(jié)點命令,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2024-01-01
文章介紹了Redis集群的概念、使用原因和搭建方法,Redis集群通過分區(qū)實現(xiàn)數(shù)據(jù)水平擴容,提供了一定的可用性,文章詳細闡述了集群的連接方式,解釋了如何分配節(jié)點,并提供了詳細的集群搭建步驟,包括創(chuàng)建節(jié)點、清空數(shù)據(jù)、修改配置、啟動節(jié)點、配置集群等2024-10-10
Redis的數(shù)據(jù)過期清除策略實現(xiàn)
Redis實現(xiàn)了數(shù)據(jù)過期清除策略,本文將深入解析Redis的數(shù)據(jù)過期清除策略,包括過期鍵的刪除方式、清除策略的選擇以及相關(guān)配置參數(shù)的介紹,感興趣的可以了解一下2024-05-05
今天想和小伙伴們聊聊用?Redis?處理接口限流，這也是最近的?TienChin?項目涉及到這個知識點了，我就拎出來和大家聊聊這個話題2022-05-05
這篇文章以圖文結(jié)合的方式詳解Windows下使用Redis緩存工具的方法，感興趣的小伙伴們可以參考一下2015-12-12
Redis數(shù)據(jù)結(jié)構(gòu)之Set結(jié)構(gòu)詳解
本文介紹了Redis中Set集合的數(shù)據(jù)結(jié)構(gòu),主要其Int種兩種編碼方式IntSet和Dict以及如何根據(jù)數(shù)據(jù)特征自動切換,IntSet通過緊湊的整數(shù)布局實現(xiàn)極致內(nèi)存節(jié)??；Dict則提供高效的唯一性校驗,兩種編碼方式和閾值機制共同實現(xiàn)了了Set的內(nèi)存效率和操作性能的間的平衡2026-05-05
Redis 提供了多種數(shù)據(jù)結(jié)構(gòu)來高效實現(xiàn) UV 統(tǒng)計,各有優(yōu)劣,本文將詳細對比 Set、Bitmap、HyperLogLog、incr + 日期維度（即用戶提到的兩種方式）四種方案,并通過流程圖和代碼示例幫助你選型,需要的朋友可以參考下2026-04-04
使用Redis控制表單重復(fù)提交和控制接口訪問頻率方式
這篇文章主要介紹了使用Redis控制表單重復(fù)提交和控制接口訪問頻率方式,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2025-06-06
在?Redis?中使用?Lua?腳本可以實現(xiàn)原子性操作、減少網(wǎng)絡(luò)開銷以及提高執(zhí)行效率,下面小編就來和大家詳細介紹一下在redis中使用lua腳本的原理與基本使用吧2025-04-04