Команда Redis RENAME

Ключи Redis

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

Синтаксис

Базовый синтаксис команды 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"
ОК

redis> RENAME message greeting
ОК

redis> EXISTS message               # message больше не существует
(целое число) 0

redis> EXISTS greeting              # greeting занимает его место
(целое число) 1


# возвращает ошибку, когда ключ не существует

redis> RENAME fake_key never_exists
(error) ERR no such key


# когда newkey уже существует, RENAME перезапишет старый newkey

redis> SET pc "lenovo"
ОК

redis> SET personal_computer "dell"
ОК

redis> RENAME pc personal_computer
ОК

redis> GET pc
(nil)

redis> GET personal_computer      # исходное значение dell было перезаписано
"lenovo"

Ключи Redis

Другие расширения