diff options
Diffstat (limited to 'iredis/data/commands/cluster-delslots.md')
-rw-r--r-- | iredis/data/commands/cluster-delslots.md | 63 |
1 files changed, 32 insertions, 31 deletions
diff --git a/iredis/data/commands/cluster-delslots.md b/iredis/data/commands/cluster-delslots.md index bd41bd7..77204e1 100644 --- a/iredis/data/commands/cluster-delslots.md +++ b/iredis/data/commands/cluster-delslots.md @@ -1,47 +1,48 @@ -In Redis Cluster, each node keeps track of which master is serving a particular -hash slot. - -The `DELSLOTS` command asks a particular Redis Cluster node to forget which -master is serving the hash slots specified as arguments. - -In the context of a node that has received a `DELSLOTS` command and has -consequently removed the associations for the passed hash slots, we say those -hash slots are _unbound_. Note that the existence of unbound hash slots occurs -naturally when a node has not been configured to handle them (something that can -be done with the `ADDSLOTS` command) and if it has not received any information -about who owns those hash slots (something that it can learn from heartbeat or -update messages). - -If a node with unbound hash slots receives a heartbeat packet from another node -that claims to be the owner of some of those hash slots, the association is -established instantly. Moreover, if a heartbeat or update message is received -with a configuration epoch greater than the node's own, the association is -re-established. +In Redis Cluster, each node keeps track of which master is serving +a particular hash slot. + +The `CLUSTER DELSLOTS` command asks a particular Redis Cluster node to +forget which master is serving the hash slots specified as arguments. + +In the context of a node that has received a `CLUSTER DELSLOTS` command and +has consequently removed the associations for the passed hash slots, +we say those hash slots are *unbound*. Note that the existence of +unbound hash slots occurs naturally when a node has not been +configured to handle them (something that can be done with the +`CLUSTER ADDSLOTS` command) and if it has not received any information about +who owns those hash slots (something that it can learn from heartbeat +or update messages). + +If a node with unbound hash slots receives a heartbeat packet from +another node that claims to be the owner of some of those hash +slots, the association is established instantly. Moreover, if a +heartbeat or update message is received with a configuration epoch +greater than the node's own, the association is re-established. However, note that: -1. The command only works if all the specified slots are already associated with - some node. +1. The command only works if all the specified slots are already +associated with some node. 2. The command fails if the same slot is specified multiple times. -3. As a side effect of the command execution, the node may go into _down_ state - because not all hash slots are covered. +3. As a side effect of the command execution, the node may go into +*down* state because not all hash slots are covered. ## Example -The following command removes the association for slots 5000 and 5001 from the -node receiving the command: +The following command removes the association for slots 5000 and +5001 from the node receiving the command: > CLUSTER DELSLOTS 5000 5001 OK ## Usage in Redis Cluster -This command only works in cluster mode and may be useful for debugging and in -order to manually orchestrate a cluster configuration when a new cluster is -created. It is currently not used by `redis-cli`, and mainly exists for API -completeness. +This command only works in cluster mode and may be useful for +debugging and in order to manually orchestrate a cluster configuration +when a new cluster is created. It is currently not used by `redis-cli`, +and mainly exists for API completeness. @return -@simple-string-reply: `OK` if the command was successful. Otherwise an error is -returned. +@simple-string-reply: `OK` if the command was successful. Otherwise +an error is returned. |