RENAMENX

语法
RENAMENX key newkey
可用版本
Redis 开源版 1.0.0
时间复杂度
O(1)
ACL 类别
@keyspace, @write, @fast,

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

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

示例

SET mykey "Hello" SET myotherkey "World" RENAMENX mykey myotherkey GET myotherkey

RESP2/RESP3 回复

以下之一

  • 整数回复:如果 *key* 被重命名为 *newkey*,则返回 `1`。
  • 整数回复:如果 *newkey* 已经存在,则返回 `0`。

历史

  • 从 Redis 3.2.0 版本开始:当源名称和目标名称相同时,命令不再返回错误。
评价此页面
回到顶部 ↑