本文内容为 http://www.redis.io/commands/rename 的翻译、注解、例子扩充及其它修改。感谢 Redis 作者 Antirez 为开源社区作出的贡献,本文保证最新、最准、最全以表示对其的敬意。欢迎留言纠错、提示更新或支持。
RENAME key newkey

将键 key 重命名为 newkey

Renames key to newkey.

当源键名与目标键名相同,或键 key 不存在时,将会返回一个错误。

It returns an error when the source and destination names are the same, or when key does not exist. 

如果 newkey 已经存在,则会被重写覆盖,当该情况发生时,命令 RENAME 内部隐式执行一次命令 DEL。所以,如果被删除键包含一个非常大的值,可能会引起较大延迟(High latency),即使命令 RENAME 自身通常为一个常量耗时(Constant-time)操作。

If newkey already exists it is overwritten, when this happens RENAME executes an implicit DEL operation, so if the deleted key contains a very big value it may cause high latency even if RENAME itself is usually a constant-time operation.