EXPIRE key seconds
为给定 key
设置生存时间,当 key
过期时(生存时间为 0
),它会被自动删除。
在 Redis 中,带有生存时间的 key
被称为『易失的』(volatile)。
生存时间可以通过使用 DEL 命令来删除整个 key
来移除,或者被 SET 和 GETSET 命令覆写(overwrite),这意味着,如果一个命令只是修改(alter)一个带生存时间的 key
的值而不是用一个新的 key
值来代替(replace)它的话,那么生存时间不会被改变。
比如说,对一个 key
执行 INCR 命令,对一个列表进行 LPUSH 命令,或者对一个哈希表执行 HSET 命令,这类操作都不会修改 key
本身的生存时间。
另一方面,如果使用 RENAME 对一个 key
进行改名,那么改名后的 key
的生存时间和改名前一样。
RENAME 命令的另一种可能是,尝试将一个带生存时间的 key
改名成另一个带生存时间的 another_key
,这时旧的 another_key
(以及它的生存时间)会被删除,然后旧的 key
会改名为 another_key
,因此,新的 another_key
的生存时间也和原本的 key
一样。
使用 PERSIST 命令可以在不删除 key
的情况下,移除 key
的生存时间,让 key
重新成为一个『持久的』(persistent) key
。
更新生存时间
可以对一个已经带有生存时间的 key
执行 EXPIRE 命令,新指定的生存时间会取代旧的生存时间。
过期时间的精确度
在 Redis 2.4 版本中,过期时间的延迟在 1 秒钟之内 —— 也即是,就算 key
已经过期,但它还是可能在过期之后一秒钟之内被访问到,而在新的 Redis 2.6 版本中,延迟被降低到 1 毫秒之内。
Redis 2.1.3 之前的不同之处
在 Redis 2.1.3 之前的版本中,修改一个带有生存时间的 key
会导致整个 key
被删除,这一行为是受当时复制(replication)层的限制而作出的,现在这一限制已经被修复。
- 可用版本:
- >= 1.0.0
- 时间复杂度:
- O(1)
- 返回值:
-
设置成功返回
1
。当key
不存在或者不能为key
设置生存时间时(比如在低于 2.1.3 版本的 Redis 中你尝试更新key
的生存时间),返回0
。
redis> SET cache_page "www.google.com" OK redis> EXPIRE cache_page 30 # 设置过期时间为 30 秒 (integer) 1 redis> TTL cache_page # 查看剩余生存时间 (integer) 23 redis> EXPIRE cache_page 30000 # 更新过期时间 (integer) 1 redis> TTL cache_page (integer) 29996
下面来通过一个demo来更好的理解:
var ac_redis = require('../common/redis.js'); var key = "test_expire"; var num = 0; function setKeyValue() { var key = "test_expire"; var data = { name: "jason", age: 11 }; ac_redis.ac_login_mq.set(key, JSON.stringify(data), "EX", 10, function (err, result) { if (err) { console.log("redis set key error:", err); return; } console.log("redis set result:", result); }); } setKeyValue(); setInterval(function () { ac_redis.ac_login_id_ttl.ttl(key, function (err, result) { if (err) { console.log("redis ttl error:", err.toString()); } console.log("result:", result); num ++; if (num >= 5) { setImmediate(function () { ac_redis.ac_login_id_ttl.expire(key, 20); console.log("redis expire"); num = 0; }); } }); }, 1000);
在控制台中你会看到每过5秒之后key的TTL就会被重置。