Multi-key operations in cluster in Redis - Step-by-Step Execution

Concept Flow - Multi-key operations in cluster

Client sends multi-key command

↓

Cluster identifies keys' hash slots

↓

Are all keys in same slot?

No→Error or Redirect

Yes↓

Command executed on node owning slot

↓

Result returned to client

The cluster checks if all keys belong to the same hash slot. If yes, it executes the command on that node; otherwise, it returns an error or redirect.

Execution Sample

Redis

MSET key1 value1 key2 value2
GET key1
GET key2

Set two keys and get their values in a Redis cluster, ensuring keys are in the same hash slot.

Execution Table

Step	Action	Keys involved	Hash Slots	Result	Notes
1	Client sends MSET command	key1, key2	slot 1234, slot 1234	Command accepted	Both keys hash to same slot
2	Cluster routes MSET to node owning slot 1234	key1, key2	slot 1234	Values set	Atomic multi-key set succeeds
3	Client sends GET key1	key1	slot 1234	value1	Single key get succeeds
4	Client sends GET key2	key2	slot 1234	value2	Single key get succeeds
5	Client sends MGET key1 key3	key1, key3	slot 1234, slot 5678	Error or Redirect	Keys in different slots, multi-key command fails

💡 Multi-key commands require all keys in the same hash slot; otherwise, cluster returns error or redirect.

Variable Tracker

Variable	Start	After Step 1	After Step 2	After Step 3	After Step 4	After Step 5
key1	null	pending set	value1	value1	value1	value1
key2	null	pending set	value2	value2	value2	value2
key3	null	null	null	null	null	null

Key Moments - 2 Insights

Why does the MGET command with keys in different slots fail?

Because Redis cluster requires all keys in multi-key commands to be in the same hash slot. The execution_table row 5 shows the error due to keys in different slots.

How does the cluster know which node to send the command to?

It calculates the hash slot for the keys and routes the command to the node owning that slot, as shown in execution_table rows 1 and 2.

Visual Quiz - 3 Questions

Look at the execution_table, what is the result of the MSET command in step 2?

A Error due to keys in different slots

B Partial values set

C Command accepted and values set

D Redirect to another node

💡 Hint

See execution_table row 2 where both keys hash to the same slot and values are set.

At which step does the cluster detect keys in different slots causing an error?

A Step 5

B Step 1

C Step 3

D Step 4

💡 Hint

Check execution_table row 5 where keys key1 and key3 have different slots.

If key2 was in a different slot, what would happen to the MSET command?

A It would partially set keys

B It would fail with error or redirect

C It would succeed normally

D It would ignore key2

💡 Hint

Refer to the cluster rule in concept_flow and execution_table row 5 about multi-key commands requiring same slot.

Concept Snapshot

Multi-key operations in Redis cluster require all keys to be in the same hash slot.
Cluster routes commands to the node owning that slot.
If keys span multiple slots, commands fail or redirect.
Use hash tags { } to force keys into same slot.
Example: MSET {user1}name "Alice" {user1}age 30

Full Transcript

In Redis cluster, multi-key commands like MSET or MGET only work if all keys belong to the same hash slot. The cluster calculates the hash slot for each key. If all keys share the same slot, the command is sent to the node owning that slot and executes successfully. If keys belong to different slots, the cluster returns an error or a redirect message. This is because Redis cluster distributes keys across nodes by hash slots to scale horizontally. To ensure multi-key commands work, keys can use hash tags (curly braces) to force them into the same slot. For example, keys like {user1}name and {user1}age hash to the same slot. This visual trace showed step-by-step how commands are routed and executed, and when errors occur due to slot mismatches.