Redis 与缓存 / 知识点
Redis 命令速查手册
Key 与过期
EXISTS key [key ...]判断一个或多个 Key 是否存在。
EXISTS
判断一个或多个 Key 是否存在。
语法
EXISTS key [key ...]示例
SET demo:1 value
EXISTS demo:1 demo:2预期结果:
(integer) 1关键边界: 返回存在 Key 的数量,不是简单布尔值。
相关命令: TYPE、DEL
TYPE key查看 Key 当前存储的数据类型。
TYPE
查看 Key 当前存储的数据类型。
语法
TYPE key示例
SET demo:1 value
TYPE demo:1预期结果:
string关键边界: 不存在的 Key 返回 none。
相关命令: EXISTS
DEL key [key ...]同步删除一个或多个 Key。
DEL
同步删除一个或多个 Key。
语法
DEL key [key ...]示例
SET demo:1 value
DEL demo:1预期结果:
(integer) 1关键边界: 删除超大 Key 可能阻塞主线程;大 Key 优先考虑 UNLINK。
相关命令: UNLINK、EXISTS
UNLINK key [key ...]异步删除 Key,把实际内存回收交给后台线程。
UNLINK
异步删除 Key,把实际内存回收交给后台线程。
语法
UNLINK key [key ...]示例
SET demo:1 value
UNLINK demo:1预期结果:
(integer) 1关键边界: 命令返回时 Key 已从键空间移除,但内存可能稍后释放。
相关命令: DEL
RENAME key newkey重命名 Key。
RENAME
重命名 Key。
语法
RENAME key newkey示例
SET old:key value
RENAME old:key new:key
GET new:key预期结果:
value关键边界: 目标 Key 已存在时会被覆盖;生产改名要特别谨慎。
相关命令: COPY
COPY source destination [DB destination-db] [REPLACE]复制 Key 到新名称或其他逻辑库。
COPY
复制 Key 到新名称或其他逻辑库。
语法
COPY source destination [DB destination-db] [REPLACE]版本: Redis >= 6.2
示例
SET source:key value
COPY source:key backup:key
GET backup:key预期结果:
(integer) 1
value关键边界: 默认不覆盖目标 Key;需要覆盖时显式使用 REPLACE。
相关命令: DUMP、RESTORE
EXPIRE key seconds [NX | XX | GT | LT]给 Key 设置秒级 TTL。
EXPIRE
给 Key 设置秒级 TTL。
语法
EXPIRE key seconds [NX | XX | GT | LT]示例
SET session:1 value
EXPIRE session:1 60
TTL session:1预期结果:
(integer) 1
(integer) 60关键边界: 更新 Key 的值是否保留 TTL 取决于具体写命令;SET 默认会清除旧 TTL,除非使用 KEEPTTL。
相关命令: TTL、PEXPIRE、PERSIST
PEXPIRE key milliseconds [NX | XX | GT | LT]给 Key 设置毫秒级 TTL。
PEXPIRE
给 Key 设置毫秒级 TTL。
语法
PEXPIRE key milliseconds [NX | XX | GT | LT]示例
SET session:1 value
PEXPIRE session:1 5000
PTTL session:1预期结果:
(integer) 1
(integer) <MILLISECONDS>关键边界: 适合需要毫秒精度的过期控制。
相关命令: PTTL、EXPIRE
EXPIREAT key unix-time-seconds [NX | XX | GT | LT]按 Unix 秒时间戳设置绝对过期时间。
EXPIREAT
按 Unix 秒时间戳设置绝对过期时间。
语法
EXPIREAT key unix-time-seconds [NX | XX | GT | LT]示例
SET token:1 value
EXPIREAT token:1 4102444800
EXPIRETIME token:1预期结果:
(integer) 1
(integer) 4102444800关键边界: 使用绝对时间时要确认服务器时钟正确。
相关命令: EXPIRETIME、PEXPIREAT
TTL key读取 Key 剩余秒级 TTL。
TTL
读取 Key 剩余秒级 TTL。
语法
TTL key示例
SET temp:key value EX 60
TTL temp:key预期结果:
(integer) <SECONDS>关键边界: -1 表示 Key 存在但无过期时间,-2 表示 Key 不存在。
相关命令: PTTL、EXPIRE
PTTL key读取 Key 剩余毫秒级 TTL。
PTTL
读取 Key 剩余毫秒级 TTL。
语法
PTTL key示例
SET temp:key value PX 5000
PTTL temp:key预期结果:
(integer) <MILLISECONDS>关键边界: -1 表示永久,-2 表示不存在。
相关命令: TTL、PEXPIRE
EXPIRETIME key读取 Key 的秒级绝对过期时间戳。
EXPIRETIME
读取 Key 的秒级绝对过期时间戳。
语法
EXPIRETIME key版本: Redis >= 7.0
示例
SET temp:key value EX 60
EXPIRETIME temp:key预期结果:
(integer) <UNIX_TIME>关键边界: 比 TTL 更适合对比多节点时间点或做审计。
相关命令: TTL、EXPIREAT
PERSIST key移除 Key 的过期时间,使其永久存在。
PERSIST
移除 Key 的过期时间,使其永久存在。
语法
PERSIST key示例
SET temp:key value EX 60
PERSIST temp:key
TTL temp:key预期结果:
(integer) 1
(integer) -1关键边界: 只移除 TTL,不改变 Key 的值。
相关命令: EXPIRE、TTL
SCAN cursor [MATCH pattern] [COUNT count] [TYPE type]增量遍历当前数据库中的 Key。
SCAN
增量遍历当前数据库中的 Key。
语法
SCAN cursor [MATCH pattern] [COUNT count] [TYPE type]示例
SCAN 0 MATCH user:* COUNT 100预期结果:
1) "<NEXT_CURSOR>"
2) 1) "user:1"关键边界: 生产遍历优先用 SCAN;必须循环直到 cursor 再次返回 0。COUNT 是提示值,不保证每次返回固定数量。
相关命令: KEYS、HSCAN、SSCAN、ZSCAN
KEYS pattern一次性返回匹配模式的所有 Key。
KEYS
一次性返回匹配模式的所有 Key。
语法
KEYS pattern示例
KEYS user:*预期结果:
1) "user:1"
2) "user:2"关键边界: 会扫描整个键空间,生产大库不要用于常规遍历;优先使用 SCAN。
相关命令: SCAN
DUMP key序列化 Key 的值,常与 RESTORE 配合迁移。
DUMP
序列化 Key 的值,常与 RESTORE 配合迁移。
语法
DUMP key示例
SET demo:key value
DUMP demo:key预期结果:
"<BINARY_PAYLOAD>"关键边界: 返回的是 Redis 内部序列化二进制,不适合作为业务数据格式。
相关命令: RESTORE
RESTORE key ttl serialized-value [REPLACE] [ABSTTL] [IDLETIME seconds] [FREQ frequency]从 DUMP 结果恢复 Key。
RESTORE
从 DUMP 结果恢复 Key。
语法
RESTORE key ttl serialized-value [REPLACE] [ABSTTL] [IDLETIME seconds] [FREQ frequency]示例
DUMP source:key
# 将返回的二进制 payload 传给:
RESTORE target:key 0 <PAYLOAD>预期结果:
OK关键边界: 目标存在时默认报错;需要覆盖必须显式 REPLACE。ttl=0 表示不过期。
相关命令: DUMP、COPY
String
SET key value [NX | XX] [GET] [EX seconds | PX milliseconds | EXAT unix-time-seconds | PXAT unix-time-milliseconds | KEEPTTL]写入 String,并可原子设置条件和过期时间。
SET
写入 String,并可原子设置条件和过期时间。
语法
SET key value [NX | XX] [GET] [EX seconds | PX milliseconds | EXAT unix-time-seconds | PXAT unix-time-milliseconds | KEEPTTL]示例
SET lock:order:1 token NX EX 30预期结果:
OK关键边界: 分布式锁常用 NX EX,但释放锁必须校验 token,不能直接 DEL 他人的锁。
相关命令: GET、GETEX、GETDEL
GET key读取 String 值。
GET
读取 String 值。
语法
GET key示例
SET user:1:name Alice
GET user:1:name预期结果:
Alice关键边界: Key 类型不是 String 时会返回 WRONGTYPE。
相关命令: SET、MGET
MSET key value [key value ...]一次写入多个 String Key。
MSET
一次写入多个 String Key。
语法
MSET key value [key value ...]示例
MSET user:1:name Alice user:2:name Bob预期结果:
OK关键边界: 整体是一个命令,但不提供逐 Key TTL;需要 TTL 时分别处理或改用其他数据结构。
相关命令: MGET