RENAMENX

Syntax

RENAMENX key newkey

Available since:: 1.0.0
Time complexity:: O(1)
ACL categories:: @keyspace, @write, @fast,

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

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

示例

RESP2/RESP3 回复

以下之一：

Integer reply: 如果key被重命名为newkey，则返回1。
Integer reply: 如果 newkey 已经存在，则返回 0。

历史

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