Команда Redis RENAME
Команда 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> 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