Redis ZRANGE in Python (Detailed Guide w/ Code Examples)

Use Case(s)

The ZRANGE command in Redis is used to retrieve a range of members from a sorted set stored at a specified key, with scores ordered from lowest to highest. Common use cases include:

  • Pagination through items in leaderboards or score rankings.
  • Retrieving subsets of data for display where only a portion of the full set is needed.

Code Examples

Example 1: Basic Usage of ZRANGE

This example demonstrates how to use ZRANGE to get members from a sorted set between two indices.

import redis # Connect to Redis client = redis.Redis(host='localhost', port=6379, db=0) # Add some members to a sorted set client.zadd('scores', {'Alice': 50, 'Bob': 70, 'Charlie': 90}) # Get members in the sorted set from index 0 to 1 members = client.zrange('scores', 0, 1) print(members) # Output: [b'Alice', b'Bob']

Example 2: Retrieving With Scores

To retrieve members along with their scores, you can use the withscores=True parameter.

members_with_scores = client.zrange('scores', 0, -1, withscores=True) print(members_with_scores) # Output: [(b'Alice', 50.0), (b'Bob', 70.0), (b'Charlie', 90.0)]

Best Practices

  • Use Appropriate Indices: When using ZRANGE, remember that Redis indices are zero-based. Using -1 as the end index fetches all elements till the last one.
  • Connection Management: Ensure to manage connections properly either by using connection pools or closing them when not in use to avoid running out of connections.

Common Mistakes

  • Confusing Index Order: Users often forget that Redis sorts scores in ascending order by default. For descending order, consider using ZREVRANGE.
  • Ignoring Score Precision: When working with floating-point scores, be aware of precision issues. It's better to handle such data appropriately within your application logic.


Q: Can I use ZRANGE to get members based on score range? A: No, ZRANGE is used for indexed ranges. To get members based on score ranges, use ZRANGEBYSCORE.

Q: Is it possible to limit the number of returned items in ZRANGE? A: Directly limiting via ZRANGE isn't possible; however, you can specify start and stop indices to control the range. For more complex querying like pagination with limits, use ZSCAN or script a Lua solution.

Was this content helpful?

Start building today

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