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。