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

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

可用版本： >= 1.0.0

时间复杂度： O(1)

将字符串值 value 关联到 key 。

若是 key 已经持有其余值， SET 就覆写旧值， 无视类型。

当 SET 命令对一个带有生存时间（TTL）的键进行设置以后， 该键原有的 TTL 将被清除。

可选参数

从 Redis 2.6.12 版本开始， SET 命令的行为能够经过一系列参数来修改：

• EX seconds ： 将键的过时时间设置为 seconds 秒。 执行 SET key value EX seconds 的效果等同于执行 SETEX key seconds value 。
• PX milliseconds ： 将键的过时时间设置为 milliseconds 毫秒。 执行 SET key value PX milliseconds 的效果等同于执行 PSETEX key milliseconds value 。
• NX ： 只在键不存在时， 才对键进行设置操做。 执行 SET key value NX 的效果等同于执行 SETNX key value 。
• XX ： 只在键已经存在时， 才对键进行设置操做。

Note

由于 SET 命令能够经过参数来实现 SETNX 、 SETEX 以及 PSETEX 命令的效果， 因此 Redis 未来的版本可能会移除并废弃 SETNX 、 SETEX 和 PSETEX 这三个命令。

返回值

在 Redis 2.6.12 版本之前， SET 命令老是返回 OK 。

从 Redis 2.6.12 版本开始， SET 命令只在设置操做成功完成时才返回 OK ； 若是命令使用了 NX或者 XX 选项， 可是由于条件没达到而形成设置操做未执行， 那么命令将返回空批量回复（NULL Bulk Reply）。

代码示例

对不存在的键进行设置：

redis> SET key "value" OK redis> GET key "value" 

对已存在的键进行设置：

redis> SET key "new-value" OK redis> GET key "new-value" 

使用 EX 选项：

redis> SET key-with-expire-time "hello" EX 10086 OK redis> GET key-with-expire-time "hello" redis> TTL key-with-expire-time (integer) 10069 

使用 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 

使用 NX 选项：

redis> SET not-exists-key "value" NX OK # 键不存在，设置成功 redis> GET not-exists-key "value" redis> SET not-exists-key "new-value" NX (nil) # 键已经存在，设置失败 redis> GEt not-exists-key "value" # 维持原值不变 

使用 XX 选项：

redis> EXISTS exists-key (integer) 0 redis> SET exists-key "value" XX (nil) # 由于键不存在，设置失败 redis> SET exists-key "value" OK # 先给键设置一个值 redis> SET exists-key "new-value" XX OK # 设置新值成功 redis> GET exists-key "new-value"