RENAMENX

RENAMENX

RENAMENX key newkey

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

1.0.0

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

O(1)

Категории ACL:

@keyspace, @write, @fast,

Переименовывает key в newkey, если newkey ещё не существует. Возвращает ошибку, если key не существует.

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

Возврат

Целочисленный ответ, в частности:

• 1 если key был переименован в newkey.
• 0 если newkey уже существует.

Примеры

SET mykey "Hello"
SET myotherkey "World"
RENAMENX mykey myotherkey
GET myotherkey

История

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