RENAMENX命令

仅当新key不存在时重命名key

语法

RENAMENX key newkey

• 可用版本：

  1.0.0

• 时间复杂度：

  O(1)

• ACL 类别：

  @keyspace, @write, @fast

如果newkey还不存在，则将key重命名为newkey。当key不存在时，它会返回一个错误。

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

#返回

整数，具体来说：

• 1如果key重命名为newkey.

• 0如果newkey已经存在。

#例子

例子如下：

redis> SET mykey "Hello"
"OK"
redis> SET myotherkey "World"
"OK"
redis> RENAMENX mykey myotherkey
(integer) 0
redis> GET myotherkey
"World"
redis>

例子如上所述。

#历史

• 从 Redis 版本 3.2.0 开始：当源名称和目标名称相同时，该命令不再返回错误。