RENAME key newkey

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(键)