跳到主要内容
锦木信息 JINMU INFO
Redis 博客
Redis · 数据迁移

把一个键搬到另一台

DUMP 序列化、RESTORE 还原、MIGRATE 原子搬运

要把某些键从一个实例挪到另一个——换机房、拆分热点、集群重分片。Redis 用三条命令干这事:DUMP 把键序列化成一段二进制、RESTORE 在对端还原,而 MIGRATE 把这一套原子地打包完成。

▲ MIGRATE = 在源端 DUMP → 传输 → 对端 RESTORE → 源端 DEL,一气呵成atomic move
源实例 user:42 ④ 成功后 DEL ① DUMP → 二进制(值+版本+8字节CRC64) \x00\x03bar…\x0b\x00 payload + CRC64 ② 传输 → ③ RESTORE 校验 CRC 后还原 目标实例 user:42 ✓ 带着原 TTL 一起到位 整个过程对源端是原子的:传输期间源实例阻塞,要么全部搬成、要么保持原样
01 · 序列化

DUMP:把键压成一段二进制

DUMP key 把一个键的值序列化成一段 Redis 内部二进制格式(和 RDB 用的编码同源)。这段 payload 不是给人看的,它末尾带一个 8 字节的 CRC64 校验和,还编入了版本信息,用来在还原时检测损坏和版本兼容性。

DUMP user:42 # → "\x00\x03bar\x0b\x00J\x19..." 内部二进制:值 + 版本 + CRC64
!

两点要记牢:① DUMP 只序列化值,不含 TTL——过期时间在 RESTORE 时单独给。② 这段 payload 是二进制,别用 shell 变量 $(...) 去接它,很容易被编码破坏;要跨实例搬,优先用 MIGRATE 或支持原样透传的客户端。

02 · 还原

RESTORE:在对端重建

RESTORE 吃进那段 payload,在目标实例重建出一模一样的键,并可同时设定 TTL。它会先校验 CRC64 和版本,不匹配就报错,从源头杜绝搬进一个损坏的值。

RESTORE user:42 0 "<dump payload>" # ttl=0 表示不过期 RESTORE user:42 3600000 "..." REPLACE # ttl 单位毫秒;REPLACE 覆盖已存在的键
选项作用
REPLACE目标键已存在时覆盖(否则报 BUSYKEY)
ABSTTL把 ttl 当成绝对 Unix 毫秒时间戳,而非相对时长(5.0+)
IDLETIME / FREQ一并设置该键的 LRU 空闲时间 / LFU 频率计数,保留驱逐相关状态(5.0+)
i

版本方向很重要:payload 只能被同版本或更新版本的 Redis 还原。源端版本比目标新,RESTORE 可能失败。所以跨版本迁移,一般是"从旧往新搬"安全,"从新往旧搬"要先确认兼容。

03 · 原子搬运

MIGRATE:一条命令全包

手动 DUMP + 传输 + RESTORE + DEL 四步,容易在中途出错、留下"两边都有"或"两边都没"的烂摊子。MIGRATE 把这一整套打包成一条原子命令:它在源端 DUMP、把 payload 发给目标端 RESTORE、确认成功后再在源端 DEL——对源实例而言是原子的。

MIGRATE 10.0.0.9 6379 user:42 0 5000 # 目标host 端口 键 目标db 超时(ms) MIGRATE 10.0.0.9 6379 "" 0 5000 KEYS k1 k2 k3 # 批量搬多个键(键位留空串) MIGRATE ... COPY # 搬完不删源(默认会 DEL 源) MIGRATE ... REPLACE # 覆盖目标已存在的键 MIGRATE ... AUTH password # 目标需要认证时
选项作用
COPY保留源端的键(不删),变"复制"而非"移动"
REPLACE覆盖目标端同名键
KEYS k1 k2…一次搬多个键(此时命令里的 key 位置写空串 "")
AUTH / AUTH2向目标实例认证(密码 / 用户名+密码)
!

MIGRATE 是同步阻塞的:传输期间,源实例会阻塞直到完成或超时。所以搬大 key要当心——一个几百 MB 的键会卡住源端。超时(最后那个毫秒参数)只是网络 IO 的超时,不代表操作被取消。大批量迁移,宁可小批多次(KEYS 一次几十个),也别一口气搬巨量。

04 · 幕后用途

集群重分片,靠的就是它

你可能没直接用过 MIGRATE,但只要用 Redis Cluster 做过扩容/缩容,它就在幕后替你干活。集群重分片的本质,是把一部分哈希槽从一个分片挪到另一个,而"挪槽"落到底层,就是把该槽里的键一个个 MIGRATE 过去。

迁移途中,源节点把槽标为 MIGRATING、目标节点标为 IMPORTING;对还没搬过去的键,客户端在源节点正常读写,对已搬走的键,源节点回一个 ASK 重定向,让客户端临时去目标节点取——这正是"哈希槽"那篇里讲过的 ASK 的来历。

串起来看

所以 MIGRATE 不只是个"搬家工具",它是集群弹性扩缩容的基石:正因为能原子地、带 TTL 地、可靠地搬单个键,上层才能平滑地把成片的槽在节点间重新分配,而业务几乎无感。

05 · 怎么选迁移方式

搬几个键,还是搬整库

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 当心阻塞,跨版本从旧往新才稳。

DUMP=值+版本+8字节CRC64(不含TTL)· RESTORE key ttl(ms) payload [REPLACE/ABSTTL/IDLETIME/FREQ],校验CRC,只能同版本或更新版本还原 · MIGRATE 原子阻塞(DUMP+RESTORE+DEL),COPY/REPLACE/KEYS/AUTH · 集群重分片底层靠它(MIGRATING/IMPORTING/ASK) · 搬库用复制/RDB

聊聊您的数据难题

告诉我们业务现状,资深技术顾问一对一给出选型与实施建议,咨询免费。