编辑这个页面须要登录或更高权限！

Redis Rename 命令

Redis key(键)

Redis Rename 命令用于修改 key 的名称 。

语法

redis Rename 命令基本语法如下：

redis 127.0.0.1:6379> RENAME OLD_KEY_NAME NEW_KEY_NAME

可用版本

>= 1.0.0

返回值

改名成功时提示 OK ，失败时候返回一个错误。

当 OLD_KEY_NAME 和 NEW_KEY_NAME 相同，或者 OLD_KEY_NAME 不存在时，返回一个错误。 当 NEW_KEY_NAME 已经存在时， RENAME 命令将覆盖旧值。

在线示例

# key 存在且 newkey 不存在



redis> SET message "hello world"

OK



redis> RENAME message greeting

OK



redis> EXISTS message               # message 不复存在

(integer) 0



redis> EXISTS greeting              # greeting 取而代之

(integer) 1





# 当 key 不存在时，返回错误



redis> RENAME fake_key never_exists

(error) ERR no such key





# newkey 已存在时， RENAME 会覆盖旧 newkey



redis> SET pc "lenovo"

OK



redis> SET personal_computer "dell"

OK



redis> RENAME pc personal_computer

OK



redis> GET pc

(nil)



redis:1> GET personal_computer      # 原来的值 dell 被覆盖了

"lenovo"

Redis key(键)

Redis 字符串(String)Redis 键(key)