Redis 与缓存 / 系统课时

使用 Bitfield 处理整数位段

使用 Bitfield 处理整数位段

本课解决多个小整数各占一个普通 Redis 键所带来的内存浪费。你将使用 BITFIELD 在字符串中定义定长整数位段,完成读取、写入、递增,并控制溢出后的处理方式。

学习目标

  • 使用有符号或无符号整数位段
  • 按绝对偏移或字段编号读写数据
  • 配置回绕、饱和与失败三种溢出策略

位段与偏移规则

BITFIELD 支持 iN 有符号整数和 uN 无符号整数,例如 i8、u16。偏移可直接写位位置,也可使用 #编号;#1 表示按当前字段宽度跳过一个字段。

例如连续两个 u8 字段共占 16 位。第一个字段使用 #0,第二个字段使用 #1,适合保存等级、次数或小范围状态值。混用不同位宽时,显式位偏移通常更容易审查。

Bitfield 位段布局

写入并读取两个整数

下面把两个无符号 8 位整数写入同一个键,再把第一个字段增加 200。由于配置了 SAT,超过 255 后会停在上限。

bash
redis-cli DEL demo:bitfield:0803 >/dev/null
redis-cli --raw BITFIELD demo:bitfield:0803 SET u8 '#0' 120 SET u8 '#1' 30
redis-cli --raw BITFIELD demo:bitfield:0803 GET u8 '#0' GET u8 '#1'
redis-cli --raw BITFIELD demo:bitfield:0803 OVERFLOW SAT INCRBY u8 '#0' 200
redis-cli --raw BITFIELD demo:bitfield:0803 GET u8 '#0' GET u8 '#1'

预期输出:

text
0
0
120
30
255
255
30

SET 返回旧值,所以首次写入得到两个 0。最后一个字段仍为 30,说明每个子命令只作用于指定的位段。

三种溢出策略

默认 WRAP 会按整数宽度回绕,例如无符号 8 位的 255 再加 1 变为 0。SAT 会限制在最小值或最大值;FAIL 在溢出时不修改字段,并为该子命令返回空值。

OVERFLOW 只影响它后面的 INCRBY 子命令,同一条命令中可以切换策略。业务计数器通常使用 SAT 或 FAIL,避免回绕后产生看似正常但含义错误的值。

适用场景与限制

Bitfield 适合字段宽度明确、取值范围稳定且访问模式简单的紧凑数据,例如游戏角色小属性、设备状态字或限幅计数器。

它不提供字段名和结构版本。位宽或布局变更后,旧数据可能被错误解释,因此应把版本写进键名,或维护明确的编码协议。需要频繁增删字段、复杂查询或审计时,Hash 通常更易维护。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 Bitfield 处理整数位段

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通