English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

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 は存在しません
&40;integer&41; 0

redis> EXISTS greeting  # greeting が代わりに使用されます
&40;integer&41; 1


# key が存在しない場合、エラーが返されます

redis> RENAME fake_key never_exists
&40;error&41; ERR no such key


# newkey が既に存在する場合、RENAME コマンドは旧値を上書きします

redis> SET pc "lenovo"
OK

redis> SET personal_computer "dell"
OK

redis> RENAME pc personal_computer
OK

redis> GET pc
&40;nil&41;

redis:1> GET personal_computer  # 元の値 dell が上書きされた
"lenovo"

Redis key(キー)