Redis可以通过给key指定一个生存时间(秒/毫秒),当key过了这个生存时间后Redis将自动删除这个key。在一些特殊的场景下面非常有用,下面我们介绍expire、expireat、pexpire、pexpireat四个命令,其中expire和expireat单位是秒;pexpire和pexpireat是毫秒。
语法: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
语法:expireat key timestamp
expireat 的作用和 expire 类似,都用于为 key 设置生存时间。
不同在于 EXPIREAT 命令接受的时间参数是 UNIX 时间戳(unix timestamp)。
可用版本:
>= 1.2.0
时间复杂度:
O(1)
返回值:
如果生存时间设置成功,返回 1 。
当 key 不存在或没办法设置生存时间,返回 0 。
实例:
redis> SET cache www.google.com OK # 这个 key 将在 2012.12.12 过期 redis> EXPIREAT cache 1355292000 (integer) 1 redis> TTL cache (integer) 45081860
语法:pexpire key milliseconds
这个命令和 expire 命令的作用类似,但是它以毫秒为单位设置 key 的生存时间,而不像 expire 命令那样,以秒为单位。
可用版本:
>= 2.6.0
时间复杂度:
O(1)
返回值:
设置成功,返回 1
实例:
key 不存在或设置失败,返回 0 redis> SET mykey "Hello" OK redis> pexpire mykey 1500 (integer) 1 # TTL 的返回值以秒为单位 redis> TTL mykey (integer) 2 # PTTL 可以给出准确的毫秒数 redis> PTTL mykey (integer) 1499
语法:pexpireat key milliseconds-timestamp
这个命令和 EXPIREAT 命令类似,但它以毫秒为单位设置 key 的过期 unix 时间戳,而不是像 expireat 那样,以秒为单位。
可用版本:
>= 2.6.0
时间复杂度:
O(1)
返回值:
如果生存时间设置成功,返回 1 。
当 key 不存在或没办法设置生存时间时,返回 0 。
实例:
redis> SET mykey "Hello" OK redis> PEXPIREAT mykey 1555555555005 (integer) 1 # TTL 返回秒 redis> TTL mykey (integer) 223157079 # PTTL 返回毫秒 redis> PTTL mykey (integer) 223157079318
vi.
expire
expire at
p expire
p expire at
仔细观察这四个命令全部是在expire单词的前面后后面加或不加东西。如果在前面加【p】,则表示已毫秒为单位,如果在后面加【at】,则表示用于unix时间戳。