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> GET personal_computer      # 元の値 dell は上書きされました
"lenovo"

Redis key(キー)

その他の拡張機能