Redis Rename command

Redis key (key)

Redis Rename command is used to modify the key names.

grammar

redis Rename command basic syntax is as follows:

redis 127.0.0.1:6379> RENAME OLD_KEY_NAME NEW_KEY_NAME

Available versions

> = 1.0.0

return value

When renaming success prompted OK, fail when an error is returned.

When OLD_KEY_NAME same NEW_KEY_NAME, or OLD_KEY_NAME does not exist, an error is returned. When NEW_KEY_NAME already exists, RENAME command overwrites the old value.

Examples

# 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 (key)