RENAME

RENAME key newkey

可用性

1.0.0

时间复杂度

O(1)

ACL 分类

@keyspace, @write, @slow,

将 key 重命名为 newkey。如果 key 不存在，则返回错误。如果 newkey 已经存在，则会被覆盖，在这种情况下 RENAME 会执行一个隐式的 DEL 操作，因此，如果被删除的键包含一个非常大的值，即使 RENAME 本身通常是一个常数时间操作，也可能导致高延迟。

在集群模式下，key 和 newkey 都必须在同一个 **哈希槽** 中，这意味着在实践中，只有具有相同哈希标签的键才能在集群中可靠地重命名。

示例

行为变更历史

• >= 3.2.0：命令不再在源名称和目标名称相同时返回错误。

RESP2/RESP3 响应