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

Comando RENAME di Redis

键(key)Redis

Il comando RENAME di Redis viene utilizzato per modificare il nome della chiave.

Sintassi

La sintassi di base del comando RENAME di Redis è la seguente:

redis 127.0.0.1:6379> RENAME OLD_KEY_NAME NEW_KEY_NAME

Versioni disponibili

>= 1.0.0

Valore di ritorno

Quando il cambio di nome è riuscito viene restituito OK, in caso di fallimento viene restituito un errore.

Quando OLD_KEY_NAME e NEW_KEY_NAME sono uguali, o quando OLD_KEY_NAME non esiste, viene restituito un errore. 当 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"

键(key)Redis