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,两个命令之间可能被其他请求插入,形成竞态条件。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

重命名与移动键

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通