重命名

RENAME key newkey

Available since:

1.0.0

Time complexity:

O(1)

ACL categories:

@keyspace, @write, @slow,

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

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

示例

行为变更历史

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

RESP2/RESP3 回复