lettuce 4.0.Beta2 features ReadFrom Settings. ReadFrom affects how lettuce routes read operations to the members of a Redis Cluster.
By default, lettuce routes its read operations to the master node. Reading from the master returns the most recent version of the data because write operations are issued to the single master node. Reading from masters guarantees strong consistency.
You can reduce latency or improve read throughput by distributing reads to slave members of the Redis cluster for applications that do not require fully up-to-date data.
ReadFrom is set per connection, meaning you can use different connections with different
RedisClusterClient clusterClient = new RedisClusterClient(RedisURI.Builder.redis("localhost", 7379).build()); StatefulRedisClusterConnection<String, String> connection = clusterClient.connect(); connection.setReadFrom(ReadFrom.SLAVE); String value = connection.sync().get("key");
The code example illustrates how to connect a Redis Cluster. The
ReadFrom is set to
SLAVE. Writes are issued always to the master but reads are dispatched in this case to a slave node. lettuce takes care that it uses the right slave. Keys are partitioned by slot hashes; A slot is handled by one master which can be backed by zero, one or multiple slaves. A slave holds the copy of exactly one master and not the whole cluster.
Use Cases for non-master reads
The following use cases are common for using non-master read settings and encourage eventual consistency:
- Providing local reads for geographically distributed applications.
If you have Redis and application servers in multiple data centers, you may consider having a geographically distributed cluster. Using the
NEARESTsetting allows the client to read from the lowest-latency members, rather than always reading from the master node.
- Maintaining availability during a failover.
MASTER_PREFERREDif you want an application to read from the master by default, but to allow stale reads from slaves when the master node is unavailable.
MASTER_PREFERREDallows a "read-only mode" for your application during a failover.
- Increase read throughput by allowing stale reads
If you want to increase your read throughput by adding additional slave nodes to your cluster
SLAVEto read explicitly from slaves and reduce read load on the master node. Using slave reads can highly lead to stale reads.
ReadFrom settings except
MASTER may return stale data because slaves replication is asynchronous and requires some delay. You need to ensure that your application can tolerate stale data.
Read from settings
|MASTER||Default mode. Read from the current master node.|
|MASTER_PREFERRED||Read from the master, but if it is unavailable, read from slave nodes.|
|SLAVE||Read from slave nodes.|
|NEAREST||Read from any node of the cluster with the lowest latency.|
Custom read settings can be implemented by extending the
ReadFrom Settings are available in lettuce 4.0.Beta2 and can be downloaded from Github or the Maven Central Repository.
<dependency> <groupId>biz.paluch.redis</groupId> <artifactId>lettuce</artifactId> <version>4.0.Beta2</version> </dependency> <dependency> <groupId>biz.paluch.redis</groupId> <artifactId>lettuce</artifactId> <version>4.0.Beta2</version> <classifier>shaded</classifier> </dependency>
Any feedback is appreciated or file an issue on GitHub.