Redis XRANGE in Ruby (Detailed Guide w/ Code Examples)

Use Case(s)

The XRANGE command in Redis is commonly used when working with streams. It enables users to retrieve a range of messages from a stream, often for the purpose of message replay, data analysis or debugging.

Code Examples

Let's say you have a stream 'mystream' and you want to retrieve all messages from it. You can do so in Ruby using the redis-rb library like this:

require 'redis' redis = # Get all messages from the stream messages = redis.xrange('mystream', '-', '+')

In this example, the '-' symbol indicates the smallest ID possible (the beginning of the stream) and '+' indicates the greatest ID possible (the end of the stream). So, it fetches all the messages.

If you know the IDs of the messages that you're interested in, you can specify them instead of '-' and '+':

require 'redis' redis = # Get messages between specific IDs messages = redis.xrange('mystream', '1526985844828-0', '1526985856755-0')

Best Practices

When dealing with large streams, it might not be ideal to fetch all messages at once as it could lead to high memory usage. In such cases, consider using XRANGE with COUNT option to paginate through the results. Here's how you can fetch the first 100 messages:

require 'redis' redis = # Get first 100 messages from the stream messages = redis.xrange('mystream', '-', '+', count: 100)

Common Mistakes

One common mistake is to forget that XRANGE returns an array of arrays, with each inner array representing a message. The first element of the inner array is the ID of the message, and the second one is a hash with field-value pairs. So be sure to handle the data correctly.


  1. Can I use XRANGE to get the most recent messages? Yes, you can use the XREVRANGE command for this purpose. It works similarly to XRANGE but retrieves the messages in reverse order.

Was this content helpful?

Start building today

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