Redis CLUSTER ADDSLOTS 命令用于把一组 hash slots 分配给接收命令的节点。这个命令仅在 cluster 模式下生效,如果命令执行成功,节点将指定的 hash slots 映射到自身,节点将获得指定的 hash slots,同时开始向集群广播新的配置。
命令格式
CLUSTER ADDSLOTS slot [slot ...]
可用版本:>=3.0.0
时间复杂度:O(N),N 为哈希插槽的总数。
需要值得注意的是:
- 该命令只有当所有指定的 slots 在接收命令的节点上还没有分配得的情况下生效。节点将拒绝接纳已经分配到其他节点的 slots(包括它自己的)。
- 同一个 slot 被指定多次的情况下命令会失败。
- 执行这个命令有一个副作用,如果 slot 作为其中一个参数设置为 importing,一旦节点向自己分配该 slot(以前未绑定)这个状态将会被清除。
命令返回值
如果命令执行成功,返回 OK,否则返回错误信息。
使用场景
这个命令仅在 cluster 模式下生效,而且作用于 redis 集群以下操作:
- 创建新集群时,ADDSLOTS 用于主节点初始化分配可用的 hash slots。
- 为了修复有未分配 slots 的坏集群。
注意,一旦一个节点为自己分配了一个 slot 集合,它就会开始将这个信息在心跳包的头里传播出去。然而其他节点只有在它们有 slot 没有被其他节点绑定或者传播的新的 hash slot 的配置年代大于列表中的节点时才会接受这个信息。这意味着这个命令应该仅通过 redis 集群应用管理客户端例如 redsi-trib 谨慎使用,而且这个命令如果使用了错误的上下文会导致集群处于错误的状态或者导致数据丢失。
示例
以下命令分配 1 2 3 slot 到接收命令的节点:
redis> CLUSTER ADDSLOTS 1 2 3
OK
但是试图再次执行命令结果将会错误,因为 slots 已经被分配了:
redis> CLUSTER ADDSLOTS 1 2 3
ERR Slot 1 is already busy