RENAME命令将key改名为newkey。
命令格式
RENAME key newkey
可用版本:>=1.0.0
时间复杂度:O(1)
当newkey已经存在时,RENAME命令将覆盖旧值,所以相当于是一个对原newkey的删除操作,所以当原来的newkey存放大值时,RENAME操作会有很高的延迟,此时需谨慎使用。
命令参数
- key:要变更的源key名称。
- newkey:要变更的目标key名称。
命令返回值
RENAME命令在指定key不存在时,返回错误,在正常时,返回OK。
在3.2.0版本之前,key和newkey名称相同时,Redis会返回一个错误。
示例
redis> RENAME mystring newmystring # 指定key不存在,返回错误信息
(error) ERR no such key
redis> SET mystring hello
OK
redis> RENAME mystring newmystring # 指定key存在,返回OK
OK
redis> GET mystring
(nil)
redis> GET newmystring
"hello"