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 开始：当源名称和目标名称相同时，该命令不再返回错误。

反馈

如果您在此页面上发现问题，或有改进建议，请提交请求以合并或打开存储库中的问题。