Redis 与缓存 / 知识点
Redis 命令速查手册
Sorted Set
ZINCRBY key increment member原子增加成员分值。
ZINCRBY
原子增加成员分值。
语法
ZINCRBY key increment member示例
ZADD rank 100 alice
ZINCRBY rank 5 alice预期结果:
"105"关键边界: 成员不存在时按 0 创建。
相关命令: ZADD、ZSCORE
ZPOPMIN key [count]弹出并删除最低分成员。
ZPOPMIN
弹出并删除最低分成员。
语法
ZPOPMIN key [count]示例
ZADD jobs 1 low 10 high
ZPOPMIN jobs预期结果:
1) "low"
2) "1"关键边界: 会修改集合。
相关命令: ZPOPMAX
ZPOPMAX key [count]弹出并删除最高分成员。
ZPOPMAX
弹出并删除最高分成员。
语法
ZPOPMAX key [count]示例
ZADD jobs 1 low 10 high
ZPOPMAX jobs预期结果:
1) "high"
2) "10"关键边界: 适合优先队列,但并发阻塞消费可考虑 BZPOPMAX/BZMPOP。
相关命令: ZPOPMIN
ZINTER numkeys key [key ...] [WEIGHTS weight [weight ...]] [AGGREGATE SUM | MIN | MAX] [WITHSCORES]返回多个 Sorted Set 的交集。
ZINTER
返回多个 Sorted Set 的交集。
语法
ZINTER numkeys key [key ...] [WEIGHTS weight [weight ...]] [AGGREGATE SUM | MIN | MAX] [WITHSCORES]版本: Redis >= 6.2
示例
ZADD a 10 x 20 y
ZADD b 5 x
ZINTER 2 a b WITHSCORES预期结果:
1) "x"
2) "15"关键边界: 默认分值聚合方式为 SUM。
相关命令: ZUNION
ZUNION numkeys key [key ...] [WEIGHTS weight [weight ...]] [AGGREGATE SUM | MIN | MAX] [WITHSCORES]返回多个 Sorted Set 的并集。
ZUNION
返回多个 Sorted Set 的并集。
语法
ZUNION numkeys key [key ...] [WEIGHTS weight [weight ...]] [AGGREGATE SUM | MIN | MAX] [WITHSCORES]版本: Redis >= 6.2
示例
ZADD a 10 x
ZADD b 5 x 20 y
ZUNION 2 a b WITHSCORES预期结果:
1) "x"
2) "15"
3) "y"
4) "20"关键边界: 大集合聚合要评估 CPU 和返回结果规模。
相关命令: ZINTER
ZSCAN key cursor [MATCH pattern] [COUNT count]增量遍历 Sorted Set 成员与分值。
ZSCAN
增量遍历 Sorted Set 成员与分值。
语法
ZSCAN key cursor [MATCH pattern] [COUNT count]示例
ZSCAN rank 0 MATCH a* COUNT 100预期结果:
1) "<NEXT_CURSOR>"
2) 1) "alice"
2) "100"关键边界: 大 Sorted Set 遍历优先 ZSCAN。
相关命令: ZRANGE、SCAN
Bitmap、HyperLogLog 与 GEO
SETBIT key offset value设置位图指定 bit。
SETBIT
设置位图指定 bit。
语法
SETBIT key offset value示例
SETBIT online:20260825 100 1预期结果:
(integer) 0关键边界: offset 很大时会扩展 String,注意稀疏大偏移带来的内存。
相关命令: GETBIT、BITCOUNT
GETBIT key offset读取位图指定 bit。
GETBIT
读取位图指定 bit。
语法
GETBIT key offset示例
SETBIT online:20260825 100 1
GETBIT online:20260825 100预期结果:
(integer) 1关键边界: 底层仍是 String。
相关命令: SETBIT
BITCOUNT key [start end [BYTE | BIT]]统计位图中值为 1 的 bit 数量。
BITCOUNT
统计位图中值为 1 的 bit 数量。
语法
BITCOUNT key [start end [BYTE | BIT]]示例
SETBIT online 1 1
SETBIT online 10 1
BITCOUNT online预期结果:
(integer) 2关键边界: 适合签到、在线状态等位统计。
相关命令: SETBIT
BITOP AND | OR | XOR | NOT destkey key [key ...]对多个位图执行位运算并写入目标 Key。
BITOP
对多个位图执行位运算并写入目标 Key。
语法
BITOP AND | OR | XOR | NOT destkey key [key ...]示例
SETBIT a 1 1
SETBIT b 2 1
BITOP OR c a b
BITCOUNT c预期结果:
(integer) <BYTES>
(integer) 2关键边界: 会写目标 Key;源位图很大时要评估 CPU。
相关命令: BITCOUNT
PFADD key element [element ...]向 HyperLogLog 添加元素。
PFADD
向 HyperLogLog 添加元素。
语法
PFADD key element [element ...]示例
PFADD uv user1 user2 user1预期结果:
(integer) 1关键边界: 用于近似去重计数,不能取回成员列表。
相关命令: PFCOUNT、PFMERGE
PFCOUNT key [key ...]估算 HyperLogLog 基数。
PFCOUNT
估算 HyperLogLog 基数。
语法
PFCOUNT key [key ...]示例
PFADD uv user1 user2 user3
PFCOUNT uv预期结果:
(integer) 3关键边界: 结果是近似值,适合 UV 等允许误差的统计。
相关命令: PFADD
PFMERGE destkey sourcekey [sourcekey ...]合并多个 HyperLogLog。
PFMERGE
合并多个 HyperLogLog。
语法
PFMERGE destkey sourcekey [sourcekey ...]示例
PFADD uv:a a b
PFADD uv:b b c
PFMERGE uv:all uv:a uv:b
PFCOUNT uv:all预期结果:
OK
(integer) 3关键边界: 目标 Key 会被覆盖为合并后的 HLL。
相关命令: PFCOUNT
GEOADD key [NX | XX] [CH] longitude latitude member [longitude latitude member ...]向地理索引添加坐标成员。
GEOADD
向地理索引添加坐标成员。
语法
GEOADD key [NX | XX] [CH] longitude latitude member [longitude latitude member ...]示例
GEOADD stores 114.0579 22.5431 shenzhen预期结果:
(integer) 1关键边界: 经度在前、纬度在后;底层使用 Sorted Set。
相关命令: GEOSEARCH、GEODIST
GEOSEARCH key FROMMEMBER member | FROMLONLAT longitude latitude BYRADIUS radius M | KM | FT | MI | BYBOX width height M | KM | FT | MI [ASC | DESC] [COUNT count [ANY]] [WITHCOORD] [WITHDIST] [WITHHASH]按中心点和半径/矩形查询附近成员。
GEOSEARCH
按中心点和半径/矩形查询附近成员。
语法
GEOSEARCH key FROMMEMBER member | FROMLONLAT longitude latitude BYRADIUS radius M | KM | FT | MI | BYBOX width height M | KM | FT | MI [ASC | DESC] [COUNT count [ANY]] [WITHCOORD] [WITHDIST] [WITHHASH]示例
GEOADD stores 114.0579 22.5431 a 114.0600 22.5450 b
GEOSEARCH stores FROMLONLAT 114.0579 22.5431 BYRADIUS 1 KM WITHDIST预期结果:
1) 1) "a"
2) "0.0000"
2) 1) "b"
2) "<DISTANCE>"关键边界: 适合附近搜索;结果排序需显式 ASC/DESC。
相关命令: GEOADD
Stream
XADD key [NOMKSTREAM] [KEEPREF | DELREF | ACKED] [MAXLEN | MINID [= | ~] threshold [LIMIT count]] * | id field value [field value ...]向 Stream 追加消息。
XADD
向 Stream 追加消息。
语法
XADD key [NOMKSTREAM] [KEEPREF | DELREF | ACKED] [MAXLEN | MINID [= | ~] threshold [LIMIT count]] * | id field value [field value ...]示例
XADD orders * orderId 1001 status created预期结果:
"<STREAM_ID>"关键边界: 使用 * 让 Redis 生成 ID。持续增长的 Stream 应配置 MAXLEN/MINID 或定期 XTRIM。
相关命令: XREAD、XTRIM
XLEN key返回 Stream 消息条数。
XLEN
返回 Stream 消息条数。
语法
XLEN key示例
XLEN orders预期结果:
(integer) <COUNT>关键边界: 用于查看积压规模,但消费者组积压应结合 XPENDING。
相关命令: XPENDING
XRANGE key start end [COUNT count]按 ID 从小到大读取 Stream 范围。
XRANGE
按 ID 从小到大读取 Stream 范围。
语法
XRANGE key start end [COUNT count]示例
XRANGE orders - + COUNT 10预期结果:
1) 1) "<STREAM_ID>"
2) 1) "orderId"
2) "1001"关键边界: - 和 + 表示最小/最大 ID。
相关命令: XREAD
XREAD [COUNT count] [BLOCK milliseconds] STREAMS key [key ...] id [id ...]从一个或多个 Stream 读取新消息。
XREAD
从一个或多个 Stream 读取新消息。
语法
XREAD [COUNT count] [BLOCK milliseconds] STREAMS key [key ...] id [id ...]示例
XREAD COUNT 10 BLOCK 5000 STREAMS orders $预期结果:
1) 1) "orders"
2) 1) 1) "<STREAM_ID>"
2) 1) "orderId"
2) "1001"关键边界: $ 表示从命令开始后的新消息,不会读取已有历史。
相关命令: XRANGE、XREADGROUP
XDEL key id [id ...]删除 Stream 指定消息。
XDEL
删除 Stream 指定消息。
语法
XDEL key id [id ...]示例
XDEL orders <STREAM_ID>预期结果:
(integer) 1关键边界: 删除消息不会自动解决消费者组 PEL 中的所有引用问题。
相关命令: XTRIM