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)