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

Команда RENAME в Redis

Redis key (ключ)

Команда RENAME в Redis используется для изменения имени ключа.

Грамматика

Основная грамматика команды RENAME в Redis:

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 заменяет greeting
(integer) 1


# При отсутствии ключа возвращается ошибка

redis> RENAME fake_key never_exists
(error) 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
(nil)

redis:1> GET personal_computer      # Старое значение dell было заменено
"lenovo"

Redis key (ключ)