SET key value [EX seconds] [PX milliseconds] [NX|XX]

    如果 key 已经持有其他值,SET 就覆写旧值,无视类型。

    SET 命令对一个带有生存时间(TTL)的键进行设置之后,该键原有的 TTL 将被清除。

    从 Redis 2.6.12 版本开始,SET 命令的行为可以通过一系列参数来修改:

    • EX seconds :将键的过期时间设置为 seconds 秒。执行 SET key value EX seconds 的效果等同于执行 SETEX key seconds value

    • PX milliseconds :将键的过期时间设置为 毫秒。执行 SET key value PX milliseconds 的效果等同于执行 PSETEX key milliseconds value

    • XX :只在键已经存在时,才对键进行设置操作。

    Note

    因为 SET 命令可以通过参数来实现 SETNXSETEX 以及 PSETEX 命令的效果,所以 Redis 将来的版本可能会移除并废弃 、 SETEXPSETEX 这三个命令。

    在 Redis 2.6.12 版本以前,SET 命令总是返回 OK

    从 Redis 2.6.12 版本开始,SET 命令只在设置操作成功完成时才返回 OK ;如果命令使用了 NX 或者 XX 选项,但是因为条件没达到而造成设置操作未执行,那么命令将返回空批量回复(NULL Bulk Reply)。

    对已存在的键进行设置:

    1. redis> SET key "new-value"
    2. OK
    3.  
    4. "new-value"

    使用 EX 选项:

    使用 PX 选项:

    1. redis> SET key-with-pexpire-time "moto" PX 123321
    2. OK
    3.  
    4. redis> GET key-with-pexpire-time
    5. "moto"
    6.  
    7. redis> PTTL key-with-pexpire-time
    8. (integer) 111939

    使用 选项:

    使用 XX 选项:

    1. redis> EXISTS exists-key
    2.  
    3. redis> SET exists-key "value" XX
    4. (nil) # 因为键不存在,设置失败
    5.  
    6. redis> SET exists-key "value"
    7. OK # 先给键设置一个值
    8.  
    9. redis> SET exists-key "new-value" XX
    10. OK # 设置新值成功
    11.  
    12. "new-value"