RENAME

RENAME

RENAME key newkey

Доступно с версии:

1.0.0

Сложность по времени:

O(1)

Категории ACL:

@keyspace, @write, @slow,

Переименовывает key в newkey. Возвращает ошибку, если key не существует. Если newkey уже существует, оно перезаписывается, при этом RENAME выполняет неявную операцию DEL, поэтому если удаляемый ключ содержит очень большое значение, это может привести к высокой задержке, даже если RENAME обычно выполняется за постоянное время.

В режиме кластера как key, так и newkey должны находиться в одном и том же хэш-слоте, что означает, что на практике переименовать ключи, имеющие одинаковый хэш-тег, можно надежно.

Возврат

Ответ в виде простой строки

Примеры

SET mykey "Hello"
RENAME mykey myotherkey
GET myotherkey

История изменений поведения

• >= 3.2.0: Команда больше не возвращает ошибку, когда имена источника и назначения совпадают.