SET

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

将字符串值 value 关联到 key 。

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

对于某个原本带有生存时间（TTL）的键来说， 当 SET 命令成功在这个键上执行时， 这个键原有的 TTL 将被清除。

可选参数

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

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

因为 SET 命令可以通过参数来实现和 SETNX 、 SETEX 和 PSETEX 三个命令的效果，所以将来的 Redis 版本可能会废弃并最终移除 SETNX 、 SETEX 和 PSETEX 这三个命令。

可用版本：

>= 1.0.0

时间复杂度：

O(1)

返回值：

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

从 Redis 2.6.12 版本开始， SET 在设置操作成功完成时，才返回 OK 。如果设置了 NX 或者 XX ，但因为条件没达到而造成设置操作未执行，那么命令返回空批量回复（NULL Bulk Reply）。

  1. # 对不存在的键进行设置
  3. redis 127.0.0.1:6379> SET key "value"
  4. OK
  6. redis 127.0.0.1:6379> GET key
  7. "value"
  9. # 对已存在的键进行设置
  11. redis 127.0.0.1:6379> SET key "new-value"
  12. OK
  14. redis 127.0.0.1:6379> GET key
  15. "new-value"
  17. # 使用 EX 选项
  19. redis 127.0.0.1:6379> SET key-with-expire-time "hello" EX 10086
  20. OK
  22. redis 127.0.0.1:6379> GET key-with-expire-time
  23. "hello"
  25. redis 127.0.0.1:6379> TTL key-with-expire-time
  26. (integer) 10069
  28. # 使用 PX 选项
  30. redis 127.0.0.1:6379> SET key-with-pexpire-time "moto" PX 123321
  31. OK
  33. redis 127.0.0.1:6379> GET key-with-pexpire-time
  34. "moto"
  36. redis 127.0.0.1:6379> PTTL key-with-pexpire-time
  37. (integer) 111939
  39. # 使用 NX 选项
  41. redis 127.0.0.1:6379> SET not-exists-key "value" NX
  42. OK      # 键不存在，设置成功
  44. redis 127.0.0.1:6379> GET not-exists-key
  45. "value"
  47. redis 127.0.0.1:6379> SET not-exists-key "new-value" NX
  48. (nil)   # 键已经存在，设置失败
  50. redis 127.0.0.1:6379> GEt not-exists-key
  51. "value" # 维持原值不变
  53. # 使用 XX 选项
  55. redis 127.0.0.1:6379> EXISTS exists-key
  56. (integer) 0
  58. redis 127.0.0.1:6379> SET exists-key "value" XX
  59. (nil)   # 因为键不存在，设置失败
  61. redis 127.0.0.1:6379> SET exists-key "value"
  62. OK      # 先给键设置一个值
  64. redis 127.0.0.1:6379> SET exists-key "new-value" XX
  65. OK      # 设置新值成功
  67. redis 127.0.0.1:6379> GET exists-key
  68. "new-value"
  70. # NX 或 XX 可以和 EX 或者 PX 组合使用
  72. redis 127.0.0.1:6379> SET key-with-expire-and-NX "hello" EX 10086 NX
  73. OK
  75. redis 127.0.0.1:6379> GET key-with-expire-and-NX
  76. "hello"
  78. redis 127.0.0.1:6379> TTL key-with-expire-and-NX
  79. (integer) 10063
  81. redis 127.0.0.1:6379> SET key-with-pexpire-and-XX "old value"
  82. OK
  84. redis 127.0.0.1:6379> SET key-with-pexpire-and-XX "new value" PX 123321
  85. OK
  87. redis 127.0.0.1:6379> GET key-with-pexpire-and-XX
  88. "new value"
  90. redis 127.0.0.1:6379> PTTL key-with-pexpire-and-XX
  91. (integer) 112999
  93. # EX 和 PX 可以同时出现，但后面给出的选项会覆盖前面给出的选项
  95. redis 127.0.0.1:6379> SET key "value" EX 1000 PX 5000000
  96. OK
  98. redis 127.0.0.1:6379> TTL key
  99. (integer) 4993  # 这是 PX 参数设置的值
  101. redis 127.0.0.1:6379> SET another-key "value" PX 5000000 EX 1000
  102. OK
  104. redis 127.0.0.1:6379> TTL another-key
  105. (integer) 997   # 这是 EX 参数设置的值

使用模式

命令 SET resource-name anystring NX EX max-lock-time 是一种在 Redis 中实现锁的简单方法。

客户端执行以上的命令：

  • 如果服务器返回 OK ，那么这个客户端获得锁。
  • 如果服务器返回 NIL ，那么客户端获取锁失败，可以在稍后再重试。
    设置的过期时间到达之后，锁将自动释放。

可以通过以下修改，让这个锁实现更健壮：

  • 不使用固定的字符串作为键的值，而是设置一个不可猜测（non-guessable）的长随机字符串，作为口令串（token）。
  • 不使用 DEL 命令来释放锁，而是发送一个 Lua 脚本，这个脚本只在客户端传入的值和键的口令串相匹配时，才对键进行删除。
    这两个改动可以防止持有过期锁的客户端误删现有锁的情况出现。

以下是一个简单的解锁脚本示例：

  1. if redis.call("get",KEYS[1]) == ARGV[1]
  2. then
  3.     return redis.call("del",KEYS[1])
  4. else
  5.     return 0
  6. end

这个脚本可以通过 EVAL …script… 1 resource-name token-value 命令来调用。

原文: https://wizardforcel.gitbooks.io/redis-doc/content/ref/48.html