Sorted Sets
Redis · Reference cheat sheet
Sorted Sets
Redis · Reference cheat sheet
📋 Overview
Sorted sets (ZSETs) store unique members with a floating-point score. Ideal for leaderboards, time indexes, and range queries by score or rank.
🔧 Core concepts
| Command | Role |
|---|---|
ZADD key score member | Add/update |
ZRANGE | By rank (low→high) |
ZREVRANGE | By rank high→low |
ZRANGEBYSCORE | By score range |
ZRANK / ZREVRANK | Rank of member |
ZSCORE | Score of member |
ZINCRBY | Increment score |
ZREM | Remove member |
ZCARD / ZCOUNT | Counts |
| Use case | Score idea |
|---|---|
| Leaderboard | Points |
| Schedule | Unix timestamp |
| Rate window | Event time |
💡 Examples
Leaderboard:
ZADD lb:game 100 alice 250 bob 180 cara
ZREVRANGE lb:game 0 2 WITHSCORES
ZINCRBY lb:game 20 aliceDue jobs by time:
ZADD queue:due 1735689600 job:1
ZRANGEBYSCORE queue:due -inf +inf LIMIT 0 10⚠️ Pitfalls
- Members are unique — re-
ZADDupdates the score. - Large ranges without
LIMITcan return huge payloads. - Lexicographical commands (
ZRANGEBYLEX) require same score — easy to misuse.