RESTORE

RESTORE

RESTORE key ttl serialized-value [REPLACE] [ABSTTL]
  [IDLETIME seconds] [FREQ frequency]

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

2.6.0

Временная сложность:

O(1) для создания нового ключа и дополнительное O(N*M) для реконструирования сериализованного значения, где N — количество Redis-объектов, составляющих значение, а M — их средний размер. Для небольших строковых значений временная сложность, таким образом, составляет O(1)+O(1*M), где M мало, поэтому просто O(1). Однако для значений упорядоченных множеств сложность составляет O(N*M*log(N)), поскольку вставка значений в упорядоченные множества имеет сложность O(log(N)).

Категории ACL:

@keyspace, @write, @slow, @dangerous,

Создаёт ключ, связанный со значением, полученным из десериализации предоставленного сериализованного значения (полученного через DUMP).

Если ttl равно 0, ключ создаётся без истечения срока действия, в противном случае устанавливается указанное время истечения срока действия (в миллисекундах).

Если использовался модификатор ABSTTL, ttl должен представлять абсолютную марку времени Unix (в миллисекундах), в которую истечёт срок действия ключа.

Для целей удаления вы можете использовать модификаторы IDLETIME или FREQ. Дополнительную информацию см. в OBJECT.

RESTORE вернёт ошибку "Имя целевого ключа занято", когда key уже существует, если вы не используете модификатор REPLACE.

RESTORE проверяет версию RDB и контрольную сумму данных. Если они не совпадают, возвращается ошибка.

Возвращаемое значение

Простой строковый ответ: Команда возвращает OK при успешном выполнении.

Примеры

redis> DEL mykey
0
redis> RESTORE mykey 0 "\n\x17\x17\x00\x00\x00\x12\x00\x00\x00\x03\x00\
                        x00\xc0\x01\x00\x04\xc0\x02\x00\x04\xc0\x03\x00\
                        xff\x04\x00u#<\xc0;.\xe9\xdd"
OK
redis> TYPE mykey
list
redis> LRANGE mykey 0 -1
1) "1"
2) "2"
3) "3"

История

• Начиная с версии Redis 3.0.0: добавлен модификатор REPLACE.
• Начиная с версии Redis 5.0.0: добавлен модификатор ABSTTL.
• Начиная с версии Redis 5.0.0: добавлены опции IDLETIME и FREQ.