• RESTORE key ttl serialized-value [REPLACE]
    • 返回值
    • 代码示例

    RESTORE key ttl serialized-value [REPLACE]

    可用版本： >= 2.6.0
    时间复杂度： 查找给定键的复杂度为 O(1) ，对键进行反序列化的复杂度为 O(NM) ，其中 N 是构成 key 的 Redis 对象的数量，而 M 则是这些对象的平均大小。 有序集合(sorted set)的反序列化复杂度为 O(NM*log(N)) ，因为有序集合每次插入的复杂度为 O(log(N)) 。 如果反序列化的对象是比较小的字符串，那么复杂度为 O(1) 。

    反序列化给定的序列化值，并将它和给定的 key 关联。

    参数 ttl 以毫秒为单位为 key 设置生存时间；如果 ttl 为 0 ，那么不设置生存时间。

    RESTORE 在执行反序列化之前会先对序列化值的 RDB 版本和数据校验和进行检查，如果 RDB 版本不相同或者数据不完整的话，那么 RESTORE 会拒绝进行反序列化，并返回一个错误。

    如果键 key 已经存在，并且给定了 REPLACE 选项，那么使用反序列化得出的值来代替键 key 原有的值；相反地，如果键 key 已经存在，但是没有给定 REPLACE 选项，那么命令返回一个错误。

    更多信息可以参考 DUMP 命令。

    返回值

    如果反序列化成功那么返回 OK ，否则返回一个错误。

    代码示例

    1. # 创建一个键，作为 DUMP 命令的输入
    2.  
    3. redis> SET greeting "hello, dumping world!"
    4. OK
    5.  
    6. redis> DUMP greeting
    7. "\x00\x15hello, dumping world!\x06\x00E\xa0Z\x82\xd8r\xc1\xde"
    8.  
    9. # 将序列化数据 RESTORE 到另一个键上面
    10.  
    11. redis> RESTORE greeting-again 0 "\x00\x15hello, dumping world!\x06\x00E\xa0Z\x82\xd8r\xc1\xde"
    12. OK
    13.  
    14. redis> GET greeting-again
    15. "hello, dumping world!"
    16.  
    17. # 在没有给定 REPLACE 选项的情况下，再次尝试反序列化到同一个键，失败
    18.  
    19. redis> RESTORE greeting-again 0 "\x00\x15hello, dumping world!\x06\x00E\xa0Z\x82\xd8r\xc1\xde"
    20. (error) ERR Target key name is busy.
    21.  
    22. # 给定 REPLACE 选项，对同一个键进行反序列化成功
    23.  
    24. redis> RESTORE greeting-again 0 "\x00\x15hello, dumping world!\x06\x00E\xa0Z\x82\xd8r\xc1\xde" REPLACE
    25. OK
    26.  
    27. # 尝试使用无效的值进行反序列化，出错
    28.  
    29. redis> RESTORE fake-message 0 "hello moto moto blah blah"
    30. (error) ERR DUMP payload version or checksum are wrong