RENAME命令

重命名key

语法

RENAME key newkey

• 可用版本：

  1.0.0

• 时间复杂度：

  O(1)

• ACL 类别：

  @keyspace, @write, @slow

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

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

#返回

简字符串

#例子

例子如下：

redis> SET mykey "Hello"
"OK"
redis> RENAME mykey myotherkey
"OK"
redis> GET myotherkey
"Hello"
redis>

例子如下所述。

#行为改变历史

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