把一个键搬到另一台
要把某些键从一个实例挪到另一个——换机房、拆分热点、集群重分片。Redis 用三条命令干这事:DUMP 把键序列化成一段二进制、RESTORE 在对端还原,而 MIGRATE 把这一套原子地打包完成。
DUMP:把键压成一段二进制
DUMP key 把一个键的值序列化成一段 Redis 内部二进制格式(和 RDB 用的编码同源)。这段 payload 不是给人看的,它末尾带一个 8 字节的 CRC64 校验和,还编入了版本信息,用来在还原时检测损坏和版本兼容性。
两点要记牢:① DUMP 只序列化值,不含 TTL——过期时间在 RESTORE 时单独给。② 这段 payload 是二进制,别用 shell 变量 $(...) 去接它,很容易被编码破坏;要跨实例搬,优先用 MIGRATE 或支持原样透传的客户端。
RESTORE:在对端重建
RESTORE 吃进那段 payload,在目标实例重建出一模一样的键,并可同时设定 TTL。它会先校验 CRC64 和版本,不匹配就报错,从源头杜绝搬进一个损坏的值。
| 选项 | 作用 |
|---|---|
| REPLACE | 目标键已存在时覆盖(否则报 BUSYKEY) |
| ABSTTL | 把 ttl 当成绝对 Unix 毫秒时间戳,而非相对时长(5.0+) |
| IDLETIME / FREQ | 一并设置该键的 LRU 空闲时间 / LFU 频率计数,保留驱逐相关状态(5.0+) |
版本方向很重要:payload 只能被同版本或更新版本的 Redis 还原。源端版本比目标新,RESTORE 可能失败。所以跨版本迁移,一般是"从旧往新搬"安全,"从新往旧搬"要先确认兼容。
MIGRATE:一条命令全包
手动 DUMP + 传输 + RESTORE + DEL 四步,容易在中途出错、留下"两边都有"或"两边都没"的烂摊子。MIGRATE 把这一整套打包成一条原子命令:它在源端 DUMP、把 payload 发给目标端 RESTORE、确认成功后再在源端 DEL——对源实例而言是原子的。
| 选项 | 作用 |
|---|---|
| COPY | 保留源端的键(不删),变"复制"而非"移动" |
| REPLACE | 覆盖目标端同名键 |
| KEYS k1 k2… | 一次搬多个键(此时命令里的 key 位置写空串 "") |
| AUTH / AUTH2 | 向目标实例认证(密码 / 用户名+密码) |
MIGRATE 是同步阻塞的:传输期间,源实例会阻塞直到完成或超时。所以搬大 key要当心——一个几百 MB 的键会卡住源端。超时(最后那个毫秒参数)只是网络 IO 的超时,不代表操作被取消。大批量迁移,宁可小批多次(KEYS 一次几十个),也别一口气搬巨量。
集群重分片,靠的就是它
你可能没直接用过 MIGRATE,但只要用 Redis Cluster 做过扩容/缩容,它就在幕后替你干活。集群重分片的本质,是把一部分哈希槽从一个分片挪到另一个,而"挪槽"落到底层,就是把该槽里的键一个个 MIGRATE 过去。
迁移途中,源节点把槽标为 MIGRATING、目标节点标为 IMPORTING;对还没搬过去的键,客户端在源节点正常读写,对已搬走的键,源节点回一个 ASK 重定向,让客户端临时去目标节点取——这正是"哈希槽"那篇里讲过的 ASK 的来历。
所以 MIGRATE 不只是个"搬家工具",它是集群弹性扩缩容的基石:正因为能原子地、带 TTL 地、可靠地搬单个键,上层才能平滑地把成片的槽在节点间重新分配,而业务几乎无感。
搬几个键,还是搬整库
DUMP/RESTORE/MIGRATE 适合按键迁移(挑一部分键搬)。如果要搬的是整个实例/整库,通常有更合适的手段:
| 场景 | 推荐方式 |
|---|---|
| 搬少量/部分键 | MIGRATE(原子、带 TTL);或 DUMP+RESTORE 自己控流程 |
| 集群扩缩容 | redis-cli --cluster reshard(底层即 MIGRATE),或托管平台自动再平衡 |
| 整库迁移到新实例 | 用主从复制把新实例挂为副本、追平后提升;或 RDB 文件拷贝后加载 |
| 持续同步/跨版本大迁移 | 专用工具(如 redis-shake 之类)做全量+增量同步 |
一句话:搬"键"用 MIGRATE,搬"库"用复制/RDB。 别用 KEYS * 配合逐个 DUMP 去模拟整库迁移——那会把源实例扫到卡死(该用 SCAN)。
序列化、传输、原子落地
DUMP 把键压成带 CRC64 的内部二进制,RESTORE 校验后在对端重建并补上 TTL,MIGRATE 则把"DUMP→传→RESTORE→DEL"打包成一条对源端原子的命令——还是集群重分片的底层基石。搬键用它们,搬整库用复制;大 key 当心阻塞,跨版本从旧往新才稳。
