Redis 与缓存 / 系统课时
迁移槽位与重新分片
迁移槽位与重新分片
Redis Cluster 扩容或节点负载失衡后,需要把部分哈希槽从一个主节点迁到另一个主节点。真正迁移的不是“节点配置”本身,而是槽位所有权和这些槽位中的键。本课用 redis-cli --cluster 完成一次定向重新分片,并解释迁移期间的 ASK 与完成后的 MOVED。
学习目标
- 理解槽位迁移时
MIGRATING、IMPORTING与键搬迁的关系 - 能使用
redis-cli --cluster reshard在两个主节点之间迁移槽位 - 能检查重新分片结果,并判断槽位均衡不等于内存绝对均衡
重新分片真正移动的是什么
Redis Cluster 固定使用 16384 个哈希槽。一个键先通过哈希计算落到某个槽,再由当前槽位映射决定访问哪个主节点。因此扩容时不需要把整个数据库一次性复制到新节点,只要挑选一部分槽,把属于这些槽的键逐步移动过去,再更新槽位所有权即可。
重新分片至少同时涉及源主节点、目标主节点、待迁移槽位和客户端路由。迁移期间槽位不能瞬间“消失再出现”,所以 Redis 用临时状态和重定向保证键可以边搬边继续服务。
单个槽位的迁移协议
开始迁移时,源节点把槽位标记为 MIGRATING,目标节点把同一槽位标记为 IMPORTING。随后工具会把属于该槽位的键从源节点批量迁移到目标节点。此时如果客户端访问的键仍在源节点,源节点可以直接处理;如果键已经搬走,源节点会返回 ASK,提示客户端临时去目标节点执行。
客户端收到 ASK 后,需要先对目标节点发送一次 ASKING,再执行原命令。等这个槽位的键迁移完成后,集群把槽位正式绑定到目标主节点。此后旧路由访问源节点时得到的是 MOVED,客户端应更新长期槽位缓存,而不是继续走临时 ASKING 流程。

使用 redis-cli 定向重新分片
执行前先用 CLUSTER NODES 找到源主节点和目标主节点的节点 ID,并确认集群当前所有槽位都已覆盖。下面示例把源主节点的 100 个槽迁移到目标主节点;将 <PORT> 与两个 <ID> 替换为你的实际值。
ENTRY_HOST=127.0.0.1
ENTRY_PORT=<PORT>
SOURCE_ID=<ID>
TARGET_ID=<ID>
SLOT_COUNT=100
redis-cli --cluster reshard $ENTRY_HOST:$ENTRY_PORT --cluster-from $SOURCE_ID --cluster-to $TARGET_ID --cluster-slots $SLOT_COUNT --cluster-yes
redis-cli --cluster check $ENTRY_HOST:$ENTRY_PORT预期输出
>>> Performing Cluster Check (using node 127.0.0.1:<PORT>)
>>> Moving slot <VALUE> from <ID> to <ID>
...
[OK] All 16384 slots covered.不同版本的 redis-cli 会打印不同数量的迁移明细,实际槽号和节点 ID 也会变化。验证重点是迁移过程没有报错,最终检查仍然显示 16384 个槽全部覆盖,且目标主节点拥有的槽数增加、源主节点拥有的槽数减少。
让槽位分布重新趋于均衡
如果目标不是定向迁移,而是让多个主节点的槽位数量重新接近平衡,可以使用 Cluster Manager 的 rebalance。它按槽位数量和可选权重计算计划,不会根据每个槽里真实键数量或内存大小做精确容量均衡。
ENTRY_HOST=127.0.0.1
ENTRY_PORT=<PORT>
redis-cli --cluster rebalance $ENTRY_HOST:$ENTRY_PORT --cluster-use-empty-masters预期输出
>>> Performing Cluster Check (using node 127.0.0.1:<PORT>)
>>> Rebalancing across <VALUE> nodes. Total weight = <VALUE>
Moving <VALUE> slots from <ID> to <ID>如果当前槽位分布已经处于工具认可的平衡范围内,也可能不发生迁移。--cluster-use-empty-masters 允许没有槽位的主节点参与重新平衡,适合新节点刚加入但尚未承载槽位的扩容场景。
迁移后的验收边界
槽位数量接近并不代表内存、键数量或请求压力一定接近。某些热点槽可能只有少量大键,另一些槽则可能拥有大量小键,所以重新分片后还应观察每个主节点的 used_memory、dbsize、CPU 和命令吞吐,再决定是否继续调整槽位。
迁移期间还要避免同时进行大规模拓扑变更。一次只控制清晰的源节点、目标节点和迁移范围,并在每轮结束后执行 --cluster check,可以把槽位未覆盖、重复归属或迁移中断的风险限制在较小范围内。