首页/数据/Redis 进阶速查/MIGRATE:跨节点迁移键

MIGRATE:跨节点迁移键

MIGRATE host port key dbid timeout 把键连同值迁移到目标实例,支持 COPY/REPLACE 选项;集群槽迁移的底层就是 MIGRATE 逐键搬运。

Redis 进阶速查数据更新于 2026-10-12
用法MIGRATE host port key 0 timeout [COPY] [REPLACE] [AUTH password]
选项COPY 保留源键、REPLACE 覆盖目标键
集群目标为 MIGRATING/IMPORTING 状态下的目标节点

示例

示例
redis-cli -p 7000 MIGRATE 10.0.0.12 7001 user:1001 0 5000
redis-cli -p 7000 MIGRATE 10.0.0.12 7001 user:1002 0 5000 REPLACE
MIGRATE 是同步阻塞操作,大 key 传输期间源节点会被占用,注意超时设置。

易错点

  • 迁移大 key 时源节点阻塞明显,先识别并拆分大 key
  • 目标已有同名键且未加 REPLACE 会报 BUSYKEY

数据来源与参考

  • Redis 官方文档:MIGRATE 命令
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌