Redis 与缓存 / 知识点
Redis 命令速查手册
Stream
XTRIM key MAXLEN | MINID [= | ~] threshold [LIMIT count]裁剪 Stream 长度或最小 ID。
XTRIM
裁剪 Stream 长度或最小 ID。
语法
XTRIM key MAXLEN | MINID [= | ~] threshold [LIMIT count]示例
XTRIM orders MAXLEN ~ 10000预期结果:
(integer) <REMOVED>关键边界: ~ 是近似裁剪,性能通常比精确 = 更好。
相关命令: XADD
XGROUP CREATE key group id | $ [MKSTREAM] [ENTRIESREAD entries-read]创建 Stream 消费者组。
XGROUP CREATE
创建 Stream 消费者组。
语法
XGROUP CREATE key group id | $ [MKSTREAM] [ENTRIESREAD entries-read]示例
XGROUP CREATE orders order-workers $ MKSTREAM预期结果:
OK关键边界: $ 只消费创建组之后的新消息;需要历史消息应指定更早 ID。
相关命令: XREADGROUP
XREADGROUP GROUP group consumer [COUNT count] [BLOCK milliseconds] [NOACK] STREAMS key [key ...] id [id ...]以消费者组身份读取 Stream。
XREADGROUP
以消费者组身份读取 Stream。
语法
XREADGROUP GROUP group consumer [COUNT count] [BLOCK milliseconds] [NOACK] STREAMS key [key ...] id [id ...]示例
XREADGROUP GROUP order-workers worker-1 COUNT 10 BLOCK 5000 STREAMS orders >预期结果:
1) 1) "orders"
2) 1) 1) "<STREAM_ID>"
2) 1) "orderId"
2) "1001"关键边界: > 表示读取尚未投递给其他消费者的新消息。成功处理后应 XACK。
相关命令: XACK、XPENDING
XACK key group id [id ...]确认消费者组消息处理完成。
XACK
确认消费者组消息处理完成。
语法
XACK key group id [id ...]示例
XACK orders order-workers <STREAM_ID>预期结果:
(integer) 1关键边界: 只有已经进入 PEL 的消息才能被确认。
相关命令: XPENDING
XPENDING key group [[IDLE min-idle-time] start end count [consumer]]查看消费者组待确认消息。
XPENDING
查看消费者组待确认消息。
语法
XPENDING key group [[IDLE min-idle-time] start end count [consumer]]示例
XPENDING orders order-workers预期结果:
1) (integer) <COUNT>
2) "<MIN_ID>"
3) "<MAX_ID>"
4) 1) 1) "worker-1"
2) "<COUNT>"关键边界: 用于判断未 ACK 积压、僵尸消费者等。
相关命令: XACK、XAUTOCLAIM
XAUTOCLAIM key group consumer min-idle-time start [COUNT count] [JUSTID]自动接管空闲时间过长的待确认消息。
XAUTOCLAIM
自动接管空闲时间过长的待确认消息。
语法
XAUTOCLAIM key group consumer min-idle-time start [COUNT count] [JUSTID]版本: Redis >= 6.2
示例
XAUTOCLAIM orders order-workers worker-2 60000 0-0 COUNT 10预期结果:
1) "<NEXT_START_ID>"
2) 1) 1) "<STREAM_ID>"
2) 1) "orderId"
2) "1001"关键边界: 适合恢复宕机消费者遗留消息;业务处理仍需幂等。
相关命令: XPENDING、XACK
Pub/Sub 与事务
PUBLISH channel message向频道发布消息。
PUBLISH
向频道发布消息。
语法
PUBLISH channel message示例
PUBLISH events "hello"预期结果:
(integer) <RECEIVER_COUNT>关键边界: Redis Pub/Sub 不持久化;订阅者离线期间消息会丢失。需要可靠消费用 Stream。
相关命令: SUBSCRIBE、XADD
SUBSCRIBE channel [channel ...]订阅一个或多个频道。
SUBSCRIBE
订阅一个或多个频道。
语法
SUBSCRIBE channel [channel ...]示例
SUBSCRIBE events预期结果:
1) "subscribe"
2) "events"
3) (integer) 1关键边界: 订阅连接进入推送模式,通常应使用独立连接。
相关命令: PUBLISH、PSUBSCRIBE
PSUBSCRIBE pattern [pattern ...]按模式订阅频道。
PSUBSCRIBE
按模式订阅频道。
语法
PSUBSCRIBE pattern [pattern ...]示例
PSUBSCRIBE events:*预期结果:
1) "psubscribe"
2) "events:*"
3) (integer) 1关键边界: 模式过宽会增加客户端消息量。
相关命令: SUBSCRIBE
PUBSUB CHANNELS [pattern]查看当前活跃频道。
PUBSUB CHANNELS
查看当前活跃频道。
语法
PUBSUB CHANNELS [pattern]示例
PUBSUB CHANNELS events:*预期结果:
1) "events:order"关键边界: 只反映当前有订阅者的频道,不是历史频道列表。
相关命令: PUBSUB NUMSUB
MULTI开始事务队列。
MULTI
开始事务队列。
语法
MULTI示例
MULTI
SET a 1
INCR a
EXEC预期结果:
OK
QUEUED
QUEUED
1) OK
2) (integer) 2关键边界: Redis 事务不提供数据库式回滚;命令运行期错误不会自动撤销之前已执行命令。
相关命令: EXEC、DISCARD、WATCH
EXEC执行 MULTI 后排队的所有命令。
EXEC
执行 MULTI 后排队的所有命令。
语法
EXEC示例
MULTI
SET a 1
GET a
EXEC预期结果:
OK
QUEUED
QUEUED
1) OK
2) "1"关键边界: 被 WATCH 的 Key 发生变化时,EXEC 会返回空结果表示事务放弃。
相关命令: MULTI、WATCH
DISCARD取消事务并清空已排队命令。
DISCARD
取消事务并清空已排队命令。
语法
DISCARD示例
MULTI
SET a 1
DISCARD
GET a预期结果:
OK
QUEUED
OK
(nil)关键边界: 只取消尚未 EXEC 的队列。
相关命令: MULTI
WATCH key [key ...]为事务提供乐观锁。
WATCH
为事务提供乐观锁。
语法
WATCH key [key ...]示例
WATCH stock
GET stock
MULTI
DECRBY stock 1
EXEC预期结果:
<VALUE>
OK
QUEUED
1) (integer) <NEW_VALUE>关键边界: WATCH 后到 EXEC 前 Key 被其他客户端修改,事务会失败;应用应重试完整读改写流程。
相关命令: UNWATCH、MULTI
UNWATCH取消当前连接监视的全部 Key。
UNWATCH
取消当前连接监视的全部 Key。
语法
UNWATCH示例
WATCH stock
UNWATCH预期结果:
OK
OK关键边界: EXEC 或 DISCARD 也会清除 WATCH 状态。
相关命令: WATCH
脚本与函数
EVAL script numkeys [key [key ...]] [arg [arg ...]]执行 Lua 脚本。
EVAL
执行 Lua 脚本。
语法
EVAL script numkeys [key [key ...]] [arg [arg ...]]示例
EVAL "return redis.call('GET', KEYS[1])" 1 demo:key预期结果:
"<VALUE>"关键边界: 脚本执行期间会阻塞 Redis 主线程;不要做长循环或高开销计算。Cluster 中脚本访问的 Key 必须满足槽位要求。
相关命令: EVALSHA、SCRIPT LOAD
EVALSHA sha1 numkeys [key [key ...]] [arg [arg ...]]按 SHA1 执行已缓存 Lua 脚本。
EVALSHA
按 SHA1 执行已缓存 Lua 脚本。
语法
EVALSHA sha1 numkeys [key [key ...]] [arg [arg ...]]示例
SCRIPT LOAD "return redis.call('GET', KEYS[1])"
EVALSHA <SHA1> 1 demo:key预期结果:
"<SHA1>"
"<VALUE>"关键边界: 脚本缓存丢失时可能返回 NOSCRIPT,客户端应回退到 EVAL/SCRIPT LOAD。
相关命令: SCRIPT LOAD
SCRIPT LOAD script预加载 Lua 脚本并返回 SHA1。
SCRIPT LOAD
预加载 Lua 脚本并返回 SHA1。
语法
SCRIPT LOAD script示例
SCRIPT LOAD "return 1"预期结果:
"<SHA1>"关键边界: 只加载不执行。
相关命令: EVALSHA
FCALL function numkeys [key [key ...]] [arg [arg ...]]调用 Redis Function 中已注册函数。
FCALL
调用 Redis Function 中已注册函数。
语法
FCALL function numkeys [key [key ...]] [arg [arg ...]]版本: Redis >= 7.0
示例
FCALL myfunc 1 demo:key arg1预期结果:
<FUNCTION_REPLY>关键边界: 使用前必须先加载函数库;函数同样应保持短小、确定性和槽位安全。
相关命令: FUNCTION LOAD
服务与诊断
PING [message]检查 Redis 连接是否可用。
PING
检查 Redis 连接是否可用。
语法
PING [message]示例
PING预期结果:
PONG关键边界: 只能证明当前连接能收到响应,不代表业务读写、复制、磁盘和延迟都正常。
相关命令: INFO