RENAME
语法
RENAME key newkey
- 可用版本
- Redis 开源版 1.0.0
- 时间复杂度
- O(1)
- ACL 类别
-
@keyspace
,@write
,@slow
,
将 key
重命名为 newkey
。当 key
不存在时,该命令返回错误。如果 newkey
已经存在,它将被覆盖;此时 RENAME
会执行隐式的 DEL
操作,因此如果被删除的键包含一个非常大的值,即使 RENAME
本身通常是 O(1) 时间复杂度的操作,也可能导致高延迟。
在集群模式下,key
和 newkey
必须位于同一个 hash slot 中,这意味着实际上只有具有相同 hash tag 的键才能在集群中可靠地重命名。
示例
行为变更历史
>= 3.2.0
: 当源名称和目标名称相同时,该命令不再返回错误。
RESP2/RESP3 回复
简单字符串回复:OK
。