/tags/database/ Recent content in Database on RenovZ's Notes Hugo -- gohugo.io en-us Mon, 30 Mar 2026 19:02:07 +0800 /posts/sqlite-wal-design/ Mon, 30 Mar 2026 19:02:07 +0800 /posts/sqlite-wal-design/ SQLite WAL (Write-Ahead Logging) 设计原理详解 一、源码文件位置 核心实现文件 src/wal.c - WAL 主实现 (约 4700 行代码) src/pager.c - WAL 相关的 Pager 层逻辑 配套文件 src/wal.h - WAL 接口定义 src/os_unix.c / src/os_win.c - 平台特定的 WAL 实现 源码注释位置 文件开头部分 (行 1-250) 有详细的 WAL 格式说明文档 二、WAL 核心数据结构 2.1 WAL Header (32 字节) struct { u32 magic; /* 0: 0x377f0682 (小端) 或 0x377f0683 (大端) */ u32 version; /* 4: 文件格式版本，当前 3007000 */ u32 pageSize; /* 8: 数据库页面大小，如 1024、4096 等 */ u32 ckptSeq; /* 12: Checkpoint 序列号 */ u32 salt1; /* 16: Salt-1，随机整数，每次 checkpoint 递增 */ u32 salt2; /* 20: Salt-2，随机整数，每次 checkpoint 随机化 */ u32 checksum1; /* 24: 头部校验和 - 第一部分 */ u32 checksum2; /* 28: 头部校验和 - 第二部分 */ } WalIndexHdr; 属性说明：