cluster-addslotsrange.3valkey - Man Page
Assigns new hash slot ranges to a node.
Synopsis
CLUSTER ADDSLOTSRANGE start-slot end-slot [start-slot end-slot ...]
Description
The CLUSTER ADDSLOTSRANGE is similar to the valkey-cluster-addslots(7) CLUSTER ADDSLOTS command in that they both assign hash slots to nodes.
The difference between the two commands is that CLUSTER ADDSLOTS takes a list of slots to assign to the node, while CLUSTER ADDSLOTSRANGE takes a list of slot ranges (specified by start and end slots) to assign to the node.
Reply
valkey-protocol(7) Simple string reply: OK if the command was successful. Otherwise an error is returned.
Complexity
O(N) where N is the total number of the slots between the start slot and end slot arguments.
Acl Categories
@admin @dangerous @slow
History
- Available since: 7.0.0
Example
To assign slots 1 2 3 4 5 to the node, the CLUSTER ADDSLOTS command is:
> CLUSTER ADDSLOTS 1 2 3 4 5 OK
The same operation can be completed with the following CLUSTER ADDSLOTSRANGE command:
> CLUSTER ADDSLOTSRANGE 1 5 OK
Usage in Valkey Cluster
This command only works in cluster mode and is useful in the following Valkey Cluster operations:
- To create a new cluster,
CLUSTER ADDSLOTSRANGEis used to initially set up primary nodes splitting the available hash slots among them. - In order to fix a broken cluster where certain slots are unassigned.
See Also
asking(3valkey), cluster(3valkey), cluster-addslots(3valkey), cluster-bumpepoch(3valkey), cluster-cancelslotmigrations(3valkey), cluster-count-failure-reports(3valkey), cluster-countkeysinslot(3valkey), cluster-delslots(3valkey), cluster-delslotsrange(3valkey), cluster-failover(3valkey), cluster-flushslots(3valkey), cluster-forget(3valkey), cluster-getkeysinslot(3valkey), cluster-getslotmigrations(3valkey), cluster-help(3valkey), cluster-info(3valkey), cluster-keyslot(3valkey), cluster-links(3valkey), cluster-meet(3valkey), cluster-migrateslots(3valkey), cluster-myid(3valkey), cluster-myshardid(3valkey), cluster-nodes(3valkey), cluster-replicas(3valkey), cluster-replicate(3valkey), cluster-reset(3valkey), cluster-saveconfig(3valkey), cluster-set-config-epoch(3valkey), cluster-setslot(3valkey), cluster-shards(3valkey), cluster-slot-stats(3valkey), cluster-slots(3valkey), cluster-syncslots(3valkey), readonly(3valkey), readwrite(3valkey)