RENAME

重命名键并覆盖目标。

语法

RENAME key newkey

引入版本：1.0.0

复杂度摘要：O(1)

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

将 key 重命名为 newkey。当 key 不存在时，它会返回错误。如果 newkey 已经存在，则会被覆盖，当发生这种情况时，RENAME 会执行隐式 DEL 操作，因此，如果删除的键包含非常大的值，则即使 RENAME 本身通常是恒定时间操作，也可能会导致高延迟。

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

必需参数

key

重命名键。

newkey

新的键名。具有该名称的现有键将被覆盖。

示例

redis> SET mykey "Hello"
OK
redis> RENAME mykey myotherkey
OK
redis> GET myotherkey
"Hello"

Redis Software 与 Redis Cloud 兼容性

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

*流消费者组信息不支持。

返回值

RESP2

简单字符串回复: OK.

RESP3

简单字符串回复: OK.

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