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