Redis 与缓存 / 系统课时

理解多部件 AOF 文件结构

理解多部件 AOF 文件结构

Redis 7.0 以后,AOF 不再只依赖一个不断增长的单文件,而是由 BASE、一个或多个 INCR 文件以及 manifest 协同组成。本课从磁盘文件入手,说明它们各自保存什么,以及 Redis 重启时如何确定一套有效 AOF。

学习目标

  • 区分 BASE、INCR 与 manifest 的职责
  • 解释一次 AOF 重写前后多部件文件如何切换
  • 在磁盘上定位并检查当前有效的 AOF 文件集合

三类文件共同组成 AOF

BASE 文件保存某次 AOF 重写形成的数据基线,一套有效 AOF 最多使用一个 BASE。它既可以采用 AOF 命令格式,也可以在启用 RDB preamble 时以更紧凑的 RDB 格式保存基线数据。

INCR 文件记录 BASE 建立以后继续发生的增量写入。随着重写和切换过程进行,当前有效集合中可能存在多个 INCR 文件,因此恢复不能只找到某个名字包含 aof 的文件就直接加载。

manifest 是当前有效文件集合的清单。它记录 Redis 应当采用哪个 BASE、哪些 INCR 以及相应顺序,使多个物理文件在逻辑上仍表现为一条连续的恢复历史。

BASE、INCR 与 manifest 共同组成多部件 AOF

定位 AOF 目录

多部件 AOF 被放在独立目录中。先读取 Redis 的数据目录和 appenddirname,不要凭容器镜像、发行版或历史版本的默认路径猜测文件位置。

bash
redis-cli --raw CONFIG GET dir
redis-cli --raw CONFIG GET appenddirname
redis-cli --raw CONFIG GET aof-use-rdb-preamble

预期结果中的实际路径和配置值可能不同:

text
dir
<PATH>
appenddirname
<VALUE>
aof-use-rdb-preamble
<VALUE>

实际 AOF 目录由 dir 与 appenddirname 组合得到,即 <PATH>/<VALUE>。在未修改常见默认命名的实例中,目录里可能看到类似下面的文件:

text
appendonly.aof.1.base.rdb
appendonly.aof.1.incr.aof
appendonly.aof.manifest

如果 aof-use-rdb-preamble 为 yes,BASE 常以 RDB 格式出现;因此看到 .rdb 后缀并不意味着它与 AOF 恢复链无关。

manifest 决定有效集合

检查 manifest 比单独查看目录中文件数量更重要。以下命令是片段示例,需要先把 <PATH> 和 <VALUE> 替换为前一步读取到的实际值。

bash
cat "<PATH>/<VALUE>/appendonly.aof.manifest"

预期结果

text
file appendonly.aof.1.base.rdb seq 1 type b
file appendonly.aof.1.incr.aof seq 1 type i

其中 type b 表示 BASE,type i 表示 INCR;seq 用于描述文件序列。真实文件名和序号会随着重写次数变化,因此运维脚本不应把 .1.base.rdb 或 .1.incr.aof 写死为永久名称。

AOF 重写如何切换文件

执行 AOF 重写时,Redis 根据当前内存数据生成新的 BASE;与此同时,新产生的写命令仍需被记录,不能因为正在生成基线而丢失。这些变化进入增量记录,待新 BASE 准备完成后,再通过 manifest 切换到新的有效文件集合。

恢复时则反向执行这套关系:Redis 根据 manifest 找到有效 BASE,先恢复基线状态,再依次应用其后的 INCR。只有这一整套文件组合起来,才代表当前 AOF 的有效恢复链。

理解多部件 AOF 后,排查重点就从“appendonly.aof 这个文件是否存在”转变为“BASE、按序 INCR 与 manifest 是否构成一致的有效集合”。这也是分析 AOF 重写、异常退出和恢复问题时首先要确认的磁盘结构。

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

目录与阅读设置

记录一个想法

理解多部件 AOF 文件结构

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

登录哪都通