Redis 与缓存 / 知识点
Redis 命令速查手册
Hash
HSCAN key cursor [MATCH pattern] [COUNT count] [NOVALUES]增量遍历 Hash 字段。
HSCAN
增量遍历 Hash 字段。
语法
HSCAN key cursor [MATCH pattern] [COUNT count] [NOVALUES]示例
HSCAN user:1 0 MATCH n* COUNT 100预期结果:
1) "<NEXT_CURSOR>"
2) 1) "name"
2) "Alice"关键边界: 大 Hash 遍历优先 HSCAN,直到 cursor 回到 0。
相关命令: HGETALL、SCAN
HEXPIRE key seconds [NX | XX | GT | LT] FIELDS numfields field [field ...]给 Hash 字段单独设置秒级 TTL。
HEXPIRE
给 Hash 字段单独设置秒级 TTL。
语法
HEXPIRE key seconds [NX | XX | GT | LT] FIELDS numfields field [field ...]版本: Redis >= 7.4
示例
HSET session:1 token abc profile cached
HEXPIRE session:1 60 FIELDS 1 token
HTTL session:1 FIELDS 1 token预期结果:
1) (integer) 1
1) (integer) <SECONDS>关键边界: 这是字段级过期,不是整个 Hash Key 过期。旧客户端库可能尚未提供对应 API。
相关命令: HTTL、HPERSIST
HTTL key FIELDS numfields field [field ...]读取 Hash 字段剩余秒级 TTL。
HTTL
读取 Hash 字段剩余秒级 TTL。
语法
HTTL key FIELDS numfields field [field ...]版本: Redis >= 7.4
示例
HTTL session:1 FIELDS 2 token profile预期结果:
1) (integer) <SECONDS>
2) (integer) -1关键边界: 字段不存在返回 -2,字段存在且永久返回 -1。
相关命令: HEXPIRE、HPERSIST
HPERSIST key FIELDS numfields field [field ...]移除 Hash 字段 TTL。
HPERSIST
移除 Hash 字段 TTL。
语法
HPERSIST key FIELDS numfields field [field ...]版本: Redis >= 7.4
示例
HPERSIST session:1 FIELDS 1 token
HTTL session:1 FIELDS 1 token预期结果:
1) (integer) 1
1) (integer) -1关键边界: 只影响字段级 TTL,不影响 Key 本身 TTL。
相关命令: HEXPIRE、HTTL
HGETEX key [EX seconds | PX milliseconds | EXAT unix-time-seconds | PXAT unix-time-milliseconds | PERSIST] FIELDS numfields field [field ...]读取一个或多个 Hash 字段并原子调整字段 TTL。
HGETEX
读取一个或多个 Hash 字段并原子调整字段 TTL。
语法
HGETEX key [EX seconds | PX milliseconds | EXAT unix-time-seconds | PXAT unix-time-milliseconds | PERSIST] FIELDS numfields field [field ...]版本: Redis >= 8.0
示例
HSET session:1 token abc
HGETEX session:1 EX 60 FIELDS 1 token预期结果:
1) "abc"关键边界: 属于写操作,因为会修改字段 TTL。
相关命令: HEXPIRE、HTTL
HSETEX key [FNX | FXX] [EX seconds | PX milliseconds | EXAT unix-time-seconds | PXAT unix-time-milliseconds | KEEPTTL] FIELDS numfields field value [field value ...]写入 Hash 字段并可同时设置字段 TTL。
HSETEX
写入 Hash 字段并可同时设置字段 TTL。
语法
HSETEX key [FNX | FXX] [EX seconds | PX milliseconds | EXAT unix-time-seconds | PXAT unix-time-milliseconds | KEEPTTL] FIELDS numfields field value [field value ...]版本: Redis >= 8.0
示例
HSETEX session:1 EX 60 FIELDS 1 token abc预期结果:
(integer) 1关键边界: 适合把字段写入和字段级 TTL 合成一个原子命令。
相关命令: HGETEX、HEXPIRE
List
LPUSH key element [element ...]从 List 左侧插入一个或多个元素。
LPUSH
从 List 左侧插入一个或多个元素。
语法
LPUSH key element [element ...]示例
LPUSH queue a b
LRANGE queue 0 -1预期结果:
(integer) 2
1) "b"
2) "a"关键边界: 多元素参数按从左到右依次压入,所以最终顺序会反转。
相关命令: RPUSH、LPOP
RPUSH key element [element ...]从 List 右侧插入元素。
RPUSH
从 List 右侧插入元素。
语法
RPUSH key element [element ...]示例
RPUSH queue a b
LRANGE queue 0 -1预期结果:
(integer) 2
1) "a"
2) "b"关键边界: 常用于 FIFO 队列的生产端。
相关命令: LPUSH、LPOP
LPOP key [count]从 List 左侧弹出元素。
LPOP
从 List 左侧弹出元素。
语法
LPOP key [count]示例
RPUSH queue a b
LPOP queue预期结果:
a关键边界: 弹出会删除元素;空 List 返回 nil。
相关命令: RPOP、BLPOP
RPOP key [count]从 List 右侧弹出元素。
RPOP
从 List 右侧弹出元素。
语法
RPOP key [count]示例
RPUSH queue a b
RPOP queue预期结果:
b关键边界: 适合栈或与 LPUSH 组合成队列。
相关命令: LPOP
LLEN key返回 List 元素数量。
LLEN
返回 List 元素数量。
语法
LLEN key示例
RPUSH queue a b c
LLEN queue预期结果:
(integer) 3关键边界: 可用于队列积压监控,但高频轮询应交给监控指标。
相关命令: LRANGE
LRANGE key start stop读取 List 指定范围。
LRANGE
读取 List 指定范围。
语法
LRANGE key start stop示例
RPUSH queue a b c
LRANGE queue 0 -1预期结果:
1) "a"
2) "b"
3) "c"关键边界: 0 -1 会全量返回,超大 List 不要频繁执行。
相关命令: LINDEX、LTRIM
LINDEX key index读取 List 指定位置元素。
LINDEX
读取 List 指定位置元素。
语法
LINDEX key index示例
RPUSH queue a b c
LINDEX queue 1预期结果:
b关键边界: 在长 List 深部随机访问成本高,不适合当数组频繁随机读。
相关命令: LRANGE
LTRIM key start stop只保留 List 指定范围。
LTRIM
只保留 List 指定范围。
语法
LTRIM key start stop示例
RPUSH logs a b c d
LTRIM logs -3 -1
LRANGE logs 0 -1预期结果:
OK
1) "b"
2) "c"
3) "d"关键边界: 常与 PUSH 配合维护固定长度最近记录。
相关命令: LRANGE
LREM key count element按值删除 List 中的元素。
LREM
按值删除 List 中的元素。
语法
LREM key count element示例
RPUSH queue a b a c
LREM queue 1 a
LRANGE queue 0 -1预期结果:
(integer) 1
1) "b"
2) "a"
3) "c"关键边界: count>0 从左到右,count<0 从右到左,0 删除全部匹配。
相关命令: LRANGE
LMOVE source destination LEFT|RIGHT LEFT|RIGHT原子把一个元素从一个 List 移到另一个 List。
LMOVE
原子把一个元素从一个 List 移到另一个 List。
语法
LMOVE source destination LEFT|RIGHT LEFT|RIGHT版本: Redis >= 6.2
示例
RPUSH pending job1
LMOVE pending processing LEFT RIGHT预期结果:
job1关键边界: 适合可靠队列的 pending→processing 转移。
相关命令: BLPOP
BLPOP key [key ...] timeout阻塞等待并从第一个非空 List 左侧弹出元素。
BLPOP
阻塞等待并从第一个非空 List 左侧弹出元素。
语法
BLPOP key [key ...] timeout示例
BLPOP queue 5预期结果:
1) "queue"
2) "<ELEMENT>"关键边界: 连接会阻塞直到有数据或超时;应用客户端应配置独立连接和合理 socket timeout。
相关命令: BRPOP、LPOP
BRPOP key [key ...] timeout阻塞等待并从 List 右侧弹出元素。
BRPOP
阻塞等待并从 List 右侧弹出元素。
语法
BRPOP key [key ...] timeout示例
BRPOP queue 5预期结果:
1) "queue"
2) "<ELEMENT>"关键边界: 行为与 BLPOP 类似,只是从右侧弹出。
相关命令: BLPOP、RPOP
LSET key index element修改 List 指定索引位置的值。
LSET
修改 List 指定索引位置的值。
语法
LSET key index element示例
RPUSH queue a b c
LSET queue 1 B
LRANGE queue 0 -1预期结果:
OK
1) "a"
2) "B"
3) "c"关键边界: 索引不存在会报错;长 List 深部定位成本高。
相关命令: LINDEX
Set
SADD key member [member ...]向 Set 添加成员。
SADD
向 Set 添加成员。
语法
SADD key member [member ...]示例
SADD tags redis java redis预期结果:
(integer) 2关键边界: Set 自动去重;返回实际新增成员数。
相关命令: SREM、SISMEMBER