Redis Sorted Set: Multiple Scores (Detailed Guide w/ Code Examples)

Use Case(s)

  • Ranking systems where multiple criteria (scores) need to be considered.
  • Aggregating scores from different sources for a composite ranking.
  • Implementing leaderboards that require more complex scoring mechanisms than a single numeric value.

Code Examples

To handle multiple scores in Redis sorted sets, you typically need to combine them into a single score or use workarounds since Redis does not natively support multiple scores per element.


Using redis-py and a composite key:

import redis r = redis.Redis() # Adding elements with combined scores r.zadd('myset', {'user1': 1000.5 + 500.25, 'user2': 800.75 + 600.30}) # Retrieving and using elements elements = r.zrange('myset', 0, -1, withscores=True) for element, score in elements: user = element.decode() # Split original scores if needed (reverse the combination logic used) print(f'{user}: {score}')


Using ioredis and a composite key:

const Redis = require('ioredis'); const redis = new Redis(); // Adding elements with combined scores redis.zadd('myset', 1500.75, 'user1', 1400.85, 'user2'); // Retrieving and using elements redis.zrange('myset', 0, -1, 'WITHSCORES', (err, result) => { for (let i = 0; i < result.length; i += 2) { console.log(`${result[i]}: ${result[i + 1]}`); } });


Using go-redis and a composite key:

package main import ( "fmt" "" "context" ) func main() { ctx := context.Background() rdb := redis.NewClient(&redis.Options{Addr: "localhost:6379"}) // Adding elements with combined scores rdb.ZAdd(ctx, "myset", &redis.Z{Score: 1500.75, Member: "user1"}, &redis.Z{Score: 1400.85, Member: "user2"}) // Retrieving and using elements members, _ := rdb.ZRangeWithScores(ctx, "myset", 0, -1).Result() for _, member := range members { fmt.Printf("%s: %f\n", member.Member, member.Score) } }

Common Mistakes

  • Failing to account for composite score calculations can lead to incorrect rankings.
  • Overcomplicating the key structure when simpler approaches may suffice.
  • Not handling score precision properly, leading to unexpected sorting results.


How do I separate original scores after combining them? You must store additional information or follow a reversible combination method (like encoding both scores into one).

Can Redis handle multiple scores natively? No, Redis doesn't support multiple scores for a single element in sorted sets directly; aggregation or combination methods are required.

Was this content helpful?

Start building today

Dragonfly is fully compatible with the Redis ecosystem and requires no code changes to implement.