当前状态#
- 当前学习总天数：
9 - 当前最近一次学习主题：
Day 009：Read Path / Get / MultiGet / Iterator - 当前主线阶段：
第 9 章：Read Path / Get / MultiGet / Iterator - 上一篇文章写到：
DBImpl::GetImpl -> mem/imm/current Version -> Version::Get -> TableCache::Get -> BlockBasedTable::Get- 已经讲清
SuperVersion固定读路径对象集合，snapshot sequence 固定可见性上界 - 已经讲清
Get、MultiGet、Iterator的共同骨架与职责差异 - 已经从读侧反向接上 Day 008 的 SST 结构：filter / index / data block 最终都通过
GetContext::SaveValue()处理语义 - 还没有系统展开 snapshot / sequence number 可见性、block cache 细节、prefix seek 与 partitioned filter/index
- 已学过主题：
Day 001：整体架构与 LSM-TreeDay 002：DB 打开流程与核心对象关系Day 003：Write Path / WriteBatch / Sequence NumberDay 004：WALDay 005：MemTable / SkipList / ArenaDay 006：MemTable 深入：可见性、删除、范围删除与读语义Day 007：FlushDay 008：SSTable / BlockBasedTable / 各类 BlockDay 009：Read Path / Get / MultiGet / Iterator
- 下一步建议：
先回答 Day 009 复习题，再进入 Day 010：Snapshot / Sequence Number / 可见性语义
- 当前仍需补看的关键点：
Snapshot / Sequence Number / ReadCallback / DBIter::IsVisible的完整可见性链路还没单独展开Block Cache、row cache、table cache、OS page cache 的边界还没系统拆开partitioned index / partitioned filter / prefix seek这些读优化变体还没单独展开VersionEdit / VersionSet如何在 MANIFEST 中承接新 SST 元数据还没重新接上
最近一天复习问答闸门#
- latest_review_day：
Day 009 - latest_review_file：
learning-rocksdb-day009-2026-04-26-read-path-get-multiget-iterator.md - review_status：
- review_result：
- review_answered_at：
- review_notes：
Day 009 文章已生成，等待复习问答。 - review_block_next：
yes
说明：
- 最近一天的
review_status为空时，表示该日复习题还未回答。 - 下一次如果用户说“继续”，应先回答
latest_review_day的复习题，再决定是否推进下一天。 - 只阻断最近一天，不追溯更早历史章节。
默认学习主线#
- 整体架构与 LSM-Tree
- DB 打开流程与核心对象关系
- 写路径：
Write Path / WriteBatch / Sequence Number WALMemTable / SkipList / ArenaFlushSSTable / BlockBasedTable / 各类 Block- 读路径：
Read Path / Get / MultiGet / Iterator Snapshot / Sequence Number / 可见性语义- 磁盘管理 / 文件读写抽象 /
WAL、Manifest、SST的磁盘角色 /Table Reader/Block/OS Page Cache MANIFEST / VersionEdit / VersionSetCompaction及其策略与三大放大权衡Block Cache / Bloom Filter / Prefix Bloom / Partition IndexColumn Family- 事务与并发控制
- 参数调优 /
Rate Limiter/Write Stall - 高级特性与专题深挖
每日文章索引#
| Day | 日期 | 主题 | 文章文件 | 状态 |
|---|---|---|---|---|
| 001 | 2026-04-01 | 整体架构与 LSM-Tree | learning-rocksdb-day001-2026-04-01-architecture-and-lsm-tree.md | revisit |
| 002 | 2026-04-09 | DB 打开流程与核心对象关系 | learning-rocksdb-day002-2026-04-09-db-open-and-core-object-relationships.md | done |
| 003 | 2026-04-12 | Write Path / WriteBatch / Sequence Number | learning-rocksdb-day003-2026-04-12-write-path-writebatch-sequence-number.md | done |
| 004 | 2026-04-13 | WAL | learning-rocksdb-day004-2026-04-13-wal.md | done |
| 005 | 2026-04-15 | MemTable / SkipList / Arena | learning-rocksdb-day005-2026-04-15-memtable-skiplist-arena.md | done |
| 006 | 2026-04-18 | MemTable 深入：可见性、删除、范围删除与读语义 | learning-rocksdb-day006-2026-04-18-memtable-visibility-delete-range-tombstone.md | done |
| 007 | 2026-04-20 | Flush | learning-rocksdb-day007-2026-04-20-flush.md | revisit |
| 008 | 2026-04-22 | SSTable / BlockBasedTable / 各类 Block | learning-rocksdb-day008-2026-04-22-sstable-blockbasedtable-and-blocks.md | revisit |
| 009 | 2026-04-26 | Read Path / Get / MultiGet / Iterator | learning-rocksdb-day009-2026-04-26-read-path-get-multiget-iterator.md | next |
说明：
状态建议使用：donerevisitnext
- 如果当天只是补充问答而没有开启新的一天，优先更新对应日文章和索引状态，而不是新增一行。
章节掌握快照#
Day 001#
- 主题：
整体架构与 LSM-Tree - 文件：
learning-rocksdb-day001-2026-04-01-architecture-and-lsm-tree.md - understanding_status：
yellow - mastery_score：
4/5 - weak_points：
VersionSet / VersionEdit / MANIFEST的恢复链路还没闭环SuperVersion的安装和回收时机还只理解到第一层WriteImpl内部的写线程分组和 sequence 分配还没细看
- source_anchors：
D:\program\rocksdb\include\rocksdb\db.hD:\program\rocksdb\db\db_impl\db_impl.hD:\program\rocksdb\db\db_impl\db_impl_open.ccD:\program\rocksdb\db\db_impl\db_impl_write.ccD:\program\rocksdb\db\db_impl\db_impl.ccD:\program\rocksdb\db\db_impl\db_impl_compaction_flush.ccD:\program\rocksdb\db\column_family.hD:\program\rocksdb\db\memtable.hD:\program\rocksdb\db\memtable_list.hD:\program\rocksdb\db\version_set.hD:\program\rocksdb\db\dbformat.h
- ready_for_next：
yes - next_review_trigger：
当学习 DB 打开流程、Snapshot 或 MANIFEST 时回看 - review_status：
answered - review_result：
partial - review_answered_at：
- review_notes：
历史章节在复习问答闸门引入之前形成，先按 partial 视为可继续，但保留 revisit。 - review_block_next：
no
Day 002#
- 主题：
DB 打开流程与核心对象关系 - 文件：
learning-rocksdb-day002-2026-04-09-db-open-and-core-object-relationships.md - understanding_status：
yellow - mastery_score：
4/5 - weak_points：
VersionEditHandler的逐条 record 回放细节还没单独拆开TryRecover / best-efforts recovery分支暂时只知道骨架recovery_ctx中cfds_ / edit_lists_的精确填充时机还可以继续细读LogAndApplyForRecovery与WAL replay的职责边界还值得回看SuperVersion的“发布稳定可读视图”表述后面读路径章节还要继续压实
- source_anchors：
D:\program\rocksdb\include\rocksdb\db.hD:\program\rocksdb\db\db_impl\db_impl_open.ccD:\program\rocksdb\db\db_impl\db_impl.ccD:\program\rocksdb\db\db_impl\db_impl_compaction_flush.ccD:\program\rocksdb\db\version_set.hD:\program\rocksdb\db\version_set.ccD:\program\rocksdb\db\column_family.hD:\program\rocksdb\db\column_family.cc
- ready_for_next：
yes - next_review_trigger：
当学习 WAL、MANIFEST / VersionEdit / VersionSet、Flush 或读路径时回看 - review_status：
answered - review_result：
partial - review_answered_at：
2026-04-12 - review_notes：
第一次复习问答已完成。补充澄清后，已经能区分 WAL replay 与 LogAndApplyForRecovery 的职责边界；也已经能回答 SuperVersion 组织 mem / imm / SST 并为前台读提供稳定视图。整体达到 partial，可继续推进，但建议在读路径章节回看该表述。 - review_block_next：
no
Day 003#
- 主题：
Write Path / WriteBatch / Sequence Number - 文件：
learning-rocksdb-day003-2026-04-12-write-path-writebatch-sequence-number.md - understanding_status：
yellow - mastery_score：
4/5 - weak_points：
log::Writer::AddRecord()的物理块格式还没展开WriteBatchheader 里的sequence在 WAL / replay / memtable 三处的统一作用还值得再压实SequenceNumber在 snapshot / 可见性里的消费路径还没进入
- source_anchors：
D:\program\rocksdb\include\rocksdb\db.hD:\program\rocksdb\include\rocksdb\write_batch.hD:\program\rocksdb\db\db_impl\db_impl_write.ccD:\program\rocksdb\db\write_thread.hD:\program\rocksdb\db\write_thread.ccD:\program\rocksdb\db\write_batch_internal.hD:\program\rocksdb\db\write_batch.ccD:\program\rocksdb\db\dbformat.h
- ready_for_next：
yes - next_review_trigger：
当学习 WAL、MemTable、Snapshot / Sequence Number / 可见性语义时回看 - review_status：
answered - review_result：
pass - review_answered_at：
2026-04-12 - review_notes：
第一次复习问答已完成。当前已经没有关键误解，可以进入 Day 004；但建议在 WAL 章节回看 WriteBatch header 中 sequence 的统一作用，以及 pipelined write 与默认路径的边界。 - review_block_next：
no
Day 004#
- 主题：
WAL - 文件：
learning-rocksdb-day004-2026-04-13-wal.md - understanding_status：
yellow - mastery_score：
3/5 - weak_points：
log::Writer::AddRecord()的压缩、recyclable WAL 与 checksum 细节还没完全压实wal_filter只知道入口和作用，还没看实际使用场景SequenceNumber在 recovery replay 之后如何进入读可见性判断还没进入
- source_anchors：
D:\program\rocksdb\db\db_impl\db_impl_write.ccD:\program\rocksdb\db\log_format.hD:\program\rocksdb\db\log_writer.hD:\program\rocksdb\db\log_writer.ccD:\program\rocksdb\db\log_reader.hD:\program\rocksdb\db\log_reader.ccD:\program\rocksdb\db\db_impl\db_impl_open.ccD:\program\rocksdb\include\rocksdb\wal_filter.h
- ready_for_next：
yes - next_review_trigger：
当学习 MemTable、Snapshot / Sequence Number / 可见性语义、恢复路径细节时回看 - review_status：
answered - review_result：
partial - review_answered_at：
2026-04-13 - review_notes：
第一次复习问答已完成。已经能回答 WAL 的主流程、分片类型、recovery 回放和顺序语义来源，没有关键误解；但 Q1 里仍把 “WAL payload” 和 “WAL 外层 header” 混在一起，建议在后续学习 MemTable / Snapshot 时再回看一次 payload 与 physical record 的边界。 - review_block_next：
no
Day 005#
- 主题：
MemTable / SkipList / Arena - 文件：
learning-rocksdb-day005-2026-04-15-memtable-skiplist-arena.md - understanding_status：
yellow - mastery_score：
3/5 - weak_points：
MemTable::Get()里的SaveValue路径还没有继续拆到读取判定细节InlineSkipList并发插入里的 splice 复用和校验逻辑还没有展开ConcurrentArena的 per-core shard 分配细节只看到框架，没继续顺着实现看完
- source_anchors：
D:\program\rocksdb\db\memtable.hD:\program\rocksdb\db\memtable.ccD:\program\rocksdb\memtable\skiplistrep.ccD:\program\rocksdb\memtable\inlineskiplist.hD:\program\rocksdb\memory\arena.hD:\program\rocksdb\memory\arena.ccD:\program\rocksdb\memory\concurrent_arena.hD:\program\rocksdb\db\dbformat.h
- ready_for_next：
yes - next_review_trigger：
当学习 Flush、Read Path、Snapshot / Sequence Number / 可见性语义时回看 - review_status：
answered - review_result：
partial - review_answered_at：
2026-04-16 - review_notes：
第一次复习问答已完成。已经理解 memtable 的主要角色、SkipListRep/InlineSkipList 的职责边界、arena 生命周期适配性，以及为什么读路径必须携带 sequence 语义；但 memtable entry 的精确字节布局仍有一点顺序混淆，需要后续再压实。 - review_block_next：
no
Day 006#
- 主题：
MemTable 深入：可见性、删除、范围删除与读语义 - 文件：
learning-rocksdb-day006-2026-04-18-memtable-visibility-delete-range-tombstone.md - understanding_status：
green - mastery_score：
4/5 - weak_points：
MemTable::MultiGet在存在 range tombstone 时为什么基本禁用 memtable bloom 优化，还没单独拆开MemTable::Update / UpdateCallback的 inplace update 边界和锁粒度还只看到第一层kValueTypeForSeek与 internal key 排序规则的精确关系，后续可在 Snapshot / Read Path 再压实
- source_anchors：
D:\program\rocksdb\db\lookup_key.hD:\program\rocksdb\db\dbformat.ccD:\program\rocksdb\db\dbformat.hD:\program\rocksdb\db\memtable.hD:\program\rocksdb\db\memtable.ccD:\program\rocksdb\db\write_batch.ccD:\program\rocksdb\table\block_based\block_based_table_builder.cc
- ready_for_next：
yes - next_review_trigger：
当学习 Flush、Read Path、Snapshot / Sequence Number / 可见性语义、事务时回看 - review_status：
answered - review_result：
pass - review_answered_at：
2026-04-18 - review_notes：
Day 006 复习问答已完成。整体已经能把 LookupKey、删除/范围删除的读语义、以及 seq_per_batch 在 memtable 层保持等价语义的方式串起来，没有关键误解，可以进入 Day 007；但 kValueTypeForSeek 与 internal key 排序的关系仍建议后续再压实。 - review_block_next：
no
Day 007#
- 主题：
Flush - 文件：
learning-rocksdb-day007-2026-04-20-flush.md - understanding_status：
yellow - mastery_score：
4/5 - weak_points：
atomic flush跨多个 column family 的提交流程还没单独展开mempurge / timestamp stripping这些 flush 分支目前只知道入口，没有继续深挖BuildTable(...)内部的 SST 物理写入细节刻意留到SSTable / BlockBasedTable章节再展开
- source_anchors：
D:\program\rocksdb\db\db_impl\db_impl_write.ccD:\program\rocksdb\db\db_impl\db_impl_compaction_flush.ccD:\program\rocksdb\db\flush_job.hD:\program\rocksdb\db\flush_job.ccD:\program\rocksdb\db\memtable_list.ccD:\program\rocksdb\db\db_impl\db_impl_files.ccD:\program\rocksdb\db\column_family.h
- ready_for_next：
yes - next_review_trigger：
当学习 SSTable / BlockBasedTable、MANIFEST / VersionEdit / VersionSet 或 WAL 删除路径时回看 - review_status：
answered - review_result：
partial - review_answered_at：
2026-04-21 - review_notes：
Day 007 复习问答已完成。已经理解 flush 的主链、前台/后台职责边界、LogAndApply 才是更完整的完成点，以及 DeleteWalsBefore 只是推进可删边界；但仍需再压实两个点：ScheduleFlushes 包含前台 SwitchMemtable 与 flush request 入队，而不仅是“调度后台线程”；PickMemTable 里决定 flush 输入范围的是 max_memtable_id，max_next_log_number 则用于 SetLogNumber(...) 等元数据推进。 - review_block_next：
no
Day 008#
- 主题：
SSTable / BlockBasedTable / 各类 Block - 文件：
learning-rocksdb-day008-2026-04-22-sstable-blockbasedtable-and-blocks.md - understanding_status：
yellow - mastery_score：
4/5 - weak_points：
BlockBasedTableReader如何从 footer / metaindex / index 逐层打开文件还没进入partitioned index / partitioned filter / hash index这些高级变体暂时只知道入口Block Cache / table reader / OS Page Cache的交互细节留到后续读路径与磁盘 I/O 章节BlockHandle、block trailer 和 footer 各自承载什么信息，边界还容易混淆
- source_anchors：
D:\program\rocksdb\db\builder.hD:\program\rocksdb\db\builder.ccD:\program\rocksdb\table\table_builder.hD:\program\rocksdb\table\format.hD:\program\rocksdb\table\format.ccD:\program\rocksdb\table\block_based\block_based_table_builder.hD:\program\rocksdb\table\block_based\block_based_table_builder.ccD:\program\rocksdb\table\block_based\block_builder.hD:\program\rocksdb\table\block_based\block_builder.ccD:\program\rocksdb\table\block_based\block_based_table_reader.hD:\program\rocksdb\include\rocksdb\table.h
- ready_for_next：
yes - next_review_trigger：
当学习 Read Path / Iterator、Block Cache / Bloom Filter、Disk IO / Table Reader 时回看 - review_status：
answered - review_result：
partial - review_answered_at：
2026-04-23 - review_notes：
Day 008 复习问答已完成。Q1/Q2/Q3/Q5 基本正确，主链理解已经过关；但 Q4 里把 block trailer 误写成“记录 block data 大小”。需要纠正：block trailer 是1 byte compression type + 4 bytes checksum，而块大小由 BlockHandle 携带，不包含 trailer。当前没有关键误解，可以进入 Day 009，但建议在读路径里再压实 footer / metaindex / index / BlockHandle 的关系。 - review_block_next：
no
Day 009#
- 主题：
Read Path / Get / MultiGet / Iterator - 文件：
learning-rocksdb-day009-2026-04-26-read-path-get-multiget-iterator.md - understanding_status：
yellow - mastery_score：
4/5 - weak_points：
Snapshot / Sequence Number / ReadCallback / DBIter::IsVisible的完整可见性链路还没单独展开Block Cache、row cache、table cache 与 OS page cache 的边界还没系统拆开partitioned index / partitioned filter / prefix seek这些读优化变体还没单独展开MergingIterator与DBIter的 reverse、merge operand、range tombstone 深层细节还只是建立骨架
- source_anchors：
D:\program\rocksdb\include\rocksdb\db.hD:\program\rocksdb\db\db_impl\db_impl.ccD:\program\rocksdb\db\db_impl\db_impl.hD:\program\rocksdb\db\column_family.hD:\program\rocksdb\db\dbformat.ccD:\program\rocksdb\db\lookup_key.hD:\program\rocksdb\db\memtable.ccD:\program\rocksdb\db\memtable_list.ccD:\program\rocksdb\db\version_set.ccD:\program\rocksdb\db\version_set.hD:\program\rocksdb\db\table_cache.ccD:\program\rocksdb\table\table_reader.hD:\program\rocksdb\table\get_context.hD:\program\rocksdb\table\get_context.ccD:\program\rocksdb\table\multiget_context.hD:\program\rocksdb\table\block_based\block_based_table_reader.ccD:\program\rocksdb\db\arena_wrapped_db_iter.ccD:\program\rocksdb\db\db_iter.ccD:\program\rocksdb\table\merging_iterator.cc
- ready_for_next：
no - next_review_trigger：
先完成 Day 009 复习问答；进入 Snapshot / Sequence Number / 可见性语义时回看 - review_status：
- review_result：
- review_answered_at：
- review_notes：
Day 009 文章已生成，等待复习问答。 - review_block_next：
yes
状态使用建议#
green- 通常是
4/5或5/5 - 没有关键误解
- 可以进入下一章
- 通常是
yellow- 通常是
3/5 - 或
4/5但仍有一个关键链路没完全闭环 - 可以推进，但应标记为
revisit
- 通常是
red- 通常是
0/5到2/5 - 或存在明显关键误解
- 先不要推进，先补充学习或问答
- 通常是
复习问答闸门说明：
review_status / review_result / review_block_next用来决定“现在能不能继续”understanding_status / mastery_score / weak_points用来记录“这一章学得怎么样”- 最近一天
review_status为空时，默认视为未答题，并阻断下一次继续学习
当前薄弱点与回看提示#
- 当前薄弱点：
Snapshot / Sequence Number / ReadCallback / DBIter::IsVisible的完整可见性链路Block Cache、row cache、table cache 与 OS page cache 的边界partitioned index / partitioned filter / prefix seek的实际读写差异atomic flush与普通 flush 的提交流程差异range tombstone / MultiGet / memtable bloom的组合边界VersionEditHandler的 MANIFEST 回放细节- flush 推进
min_log_number_to_keep之后，obsolete WAL 的实际删除/归档路径
- 回看触发条件：
学习 Snapshot / Sequence Number / 可见性语义学习 Block Cache / Bloom Filter / Prefix Seek学习 MANIFEST / VersionEdit / VersionSet
外部资料使用原则#
- 外部资料只作为问题来源和补充视角，不作为最终事实标准。
- 优先来源：
- RocksDB GitHub Wiki
- RocksDB GitHub Issues
- RocksDB GitHub Discussions
- RocksDB 官方文档或官方博客
- 次优先来源：
- Stack Overflow
- 知乎
- linux.do
- 高质量个人技术博客
- 最终结论必须回到
D:\program\rocksdb中的当前本地源码验证。
文章写作提醒#
- 每日文章是知识主文档，问题与问答直接写入当天文章。
- 索引文件不承载长篇知识正文。
- 当结构、流程、状态迁移或模块协作适合图示时，优先在每日文章中加入 Mermaid 图。
设计动机、横向对比、工程启发是主线文章中的可选补充模块，不是独立主线。复习题是每日文章中的强制项。- 每次完成当天文章后，应主动发起最近一天的复习问答。
最近更新时间#
- 2026-04-26T15:23:14+08:00