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
命令可以通过参数来实现 SETNX
、 SETEX
以及 PSETEX
命令的效果,所以 Redis 将来的版本可能会移除并废弃 、 SETEX
和 PSETEX
这三个命令。
在 Redis 2.6.12 版本以前,SET
命令总是返回 OK
。
从 Redis 2.6.12 版本开始,SET
命令只在设置操作成功完成时才返回 OK
;如果命令使用了 NX
或者 XX
选项,但是因为条件没达到而造成设置操作未执行,那么命令将返回空批量回复(NULL Bulk Reply)。
对已存在的键进行设置:
- redis> SET key "new-value"
- OK
- "new-value"
使用 EX
选项:
使用 PX
选项:
- redis> SET key-with-pexpire-time "moto" PX 123321
- OK
- redis> GET key-with-pexpire-time
- "moto"
- redis> PTTL key-with-pexpire-time
- (integer) 111939
使用 选项:
使用 XX
选项:
- redis> EXISTS exists-key
- redis> SET exists-key "value" XX
- (nil) # 因为键不存在,设置失败
- redis> SET exists-key "value"
- OK # 先给键设置一个值
- redis> SET exists-key "new-value" XX
- OK # 设置新值成功
- "new-value"