Redis Sorted Set: Custom Order (Detailed Guide w/ Code Examples)

Use Case(s)

  • Creating leaderboards with custom scoring algorithms.
  • Implementing task scheduling systems where tasks have custom priorities.
  • Managing ordered collections of items where order is determined by complex criteria.

Code Examples

To achieve a custom order in Redis sorted sets, you need to create a score that reflects your custom ordering logic. This often involves normalizing and combining multiple metrics into a single score.


import redis # Connect to Redis r = redis.Redis(host='localhost', port=6379, db=0) # Add elements with custom scores r.zadd('myset', {'item1': 5.5, 'item2': 3.7, 'item3': 9.1}) # Retrieve elements in custom order items = r.zrange('myset', 0, -1, withscores=True) print(items)


const redis = require("redis"); const client = redis.createClient(); client.on("error", function (error) { console.error(error); }); // Add elements with custom scores client.zadd("myset", 5.5, "item1", 3.7, "item2", 9.1, "item3", function(err, response) { if (err) throw err; // Retrieve elements in custom order client.zrange("myset", 0, -1, "WITHSCORES", function(err, items) { if (err) throw err; console.log(items); client.quit(); }); });


package main import ( "fmt" "" "context" ) func main() { ctx := context.Background() rdb := redis.NewClient(&redis.Options{ Addr: "localhost:6379", }) // Add elements with custom scores z := []*redis.Z{ {Score: 5.5, Member: "item1"}, {Score: 3.7, Member: "item2"}, {Score: 9.1, Member: "item3"}, } rdb.ZAdd(ctx, "myset", z...) // Retrieve elements in custom order items, _ := rdb.ZRangeWithScores(ctx, "myset", 0, -1).Result() for _, item := range items { fmt.Println(item.Member, item.Score) } }

Best Practices

  • Ensure your scoring algorithm is well-defined and normalized to avoid unexpected orderings.
  • Use transactions (MULTI/EXEC) if adding multiple elements to prevent inconsistent states in heavily concurrent environments.
  • Regularly monitor and optimize the scores to maintain performance and accuracy over time.

Common Mistakes

  • Using non-numeric values as scores can lead to errors; always ensure scores are valid floating-point numbers.
  • Forgetting to handle connection errors or exceptions can result in incomplete operations or data loss.
  • Not using withscores when retrieving elements; this option is crucial to understand the order and scores of the elements returned.


Q: How do I update the score of an element in a sorted set? A: Use the ZADD command with the XX option to update the score of an existing element.

Q: Can I store additional information beyond the score in a sorted set? A: You can store additional information in the member string, but it requires custom parsing logic when retrieving the data.

Was this content helpful?

Start building today

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