RENAMENX

仅当目标键名不存在时才重命名键。

语法

RENAMENX key newkey

引入版本：1.0.0

复杂度摘要：O(1)

[!NOTE] 此命令的行为在集群 Redis 环境中有所不同。请参阅 多键操作 页面了解更多信息。

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

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

必需参数

key

重命名键。

newkey

新的键名。如果具有此名称的键已存在，则该命令将失败。

示例

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

Redis Software 与 Redis Cloud 兼容性

Redis 软件	Redis Cloud	说明
✅ 标准 ✅ 主动-主动	✅ 标准 ✅ 主动-主动	对于双活或集群数据库，原始键和新键必须位于同一个哈希槽中。

返回值

RESP2

以下之一： * 整数回复：1（如果 关键 已重命名为 新钥匙）。 * 整数回复：如果 新钥匙 已存在，则为 0。

RESP3

以下之一： * 整数回复：1（如果 关键 已重命名为 新钥匙）。 * 整数回复：如果 新钥匙 已存在，则为 0。

资料来源：Redis 官方 RENAMENX 文档；中文内容参考 Redis 文档许可。