Redis 基础教程

Redis 命令

Redis 高级教程

Redis 笔记

Redis RENAME 命令

Redis 键(Keys) Redis 键(Keys)


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"