Redis 与缓存 / 系统课时
重命名与移动键
重命名与移动键
本课解决键名调整和同一实例内逻辑数据库迁移的问题。你将学会使用 RENAME、RENAMENX 与 MOVE,理解覆盖、目标冲突和适用范围,并在操作后验证值、类型与 TTL。
学习目标
- 使用
RENAME与RENAMENX修改键名 - 使用
MOVE将键移动到其他逻辑数据库 - 识别覆盖风险、目标冲突和集群限制
RENAME 与覆盖行为
RENAME source destination 原子修改键名。源键不存在时命令报错;目标键已存在时会被源键覆盖。重命名不会改变值、逻辑类型和剩余 TTL。
RENAMENX 只在目标键不存在时执行。返回 1 表示成功,返回 0 表示目标键已存在,因此适合不能覆盖旧数据的切换场景。
主示例:安全重命名并移动
下面先演示 RENAMENX 遇到目标冲突,再使用新目标名完成重命名,最后把键从数据库 0 移动到数据库 1。
bash
redis-cli -n 0 DEL draft:config active:config candidate:config
redis-cli -n 1 DEL candidate:config
redis-cli -n 0 SET draft:config v2 EX 600
redis-cli -n 0 SET active:config v1
redis-cli -n 0 RENAMENX draft:config active:config
redis-cli -n 0 RENAMENX draft:config candidate:config
redis-cli -n 0 TTL candidate:config
redis-cli -n 0 MOVE candidate:config 1
redis-cli -n 0 EXISTS candidate:config
redis-cli -n 1 GET candidate:config预期输出:
text
(integer) <DB0_DELETED_COUNT>
(integer) <DB1_DELETED_COUNT>
OK
OK
(integer) 0
(integer) 1
(integer) <REMAINING_SECONDS>
(integer) 1
(integer) 0
"v2"<DB0_DELETED_COUNT> 与 <DB1_DELETED_COUNT> 取决于测试前状态。<REMAINING_SECONDS> 应为正数且不大于 600,说明重命名保留了原 TTL。最后数据库 0 中键已不存在,数据库 1 中仍可读取原值。
MOVE 的适用范围
MOVE key db 只能在同一个 Redis 实例的逻辑数据库之间移动。源键不存在,或目标数据库已经有同名键时,命令都返回 0,且不会覆盖目标键。
Redis Cluster 只支持数据库 0,因此不能使用 MOVE 做集群数据分区。跨实例或跨集群迁移应使用应用层复制、专用迁移工具或备份恢复流程。
操作前后的检查
执行变更前,应确认 Redis 地址、当前数据库、源键、目标键和剩余 TTL。执行后,再验证新键的 TYPE、值和 TTL,并确认旧键已消失。
不要用客户端“先 EXISTS、再 RENAME”代替 RENAMENX,两个命令之间可能被其他请求插入,形成竞态条件。
按自己的节奏,确认真正理解。