Android 9 引入了 SQLiteDatabase 的一种特殊模式,称为“兼容性 WAL(预写日志记录)”,它允许数据库使用 journal_mode=WAL,同时保留每个数据库最多创建一个连接的行为。
默认情况下,系统会为应用的数据库启用兼容性 WAL,除非应用已执行以下任一操作:
通过调用以下内容明确请求了 journal 模式:SQLiteDatabase.OpenParams.setJournalMode(String mode)
启用 WAL journal 模式可显著提升性能并减少写入量。例如,在 ext4 文件系统中,WAL 可将写入速度提高 4 倍。
兼容性 WAL 默认处于启用状态,且无需任何额外的实现操作。
注意:对于使用 Room 的应用,系统会默认启用完全预写日志记录模式(而非兼容性 WAL)。这适用于运行 API 16 或更高版本且未被归为低内存设备的设备。如需了解详情,请参阅 RoomDatabase.JournalMode AUTOMATIC。
停用兼容性 WAL
例如:
false
如果对于某些配置而言,WAL journal 模式的性能与原有回滚 journal 模式相比没有提升,您可能想为这种配置停用兼容性 WAL。例如,在 F2FS 文件系统中,虽然 SQLite 支持原子写入且 DELETE journal 性能与 WAL 类似,但 WAL 可以将写入量提高 10% 到 15%。
验证
要验证兼容性 WAL 模式,请从 CtsDatabaseTestCases 模块运行 CTS 测试。CTS 测试将在启用兼容性 WAL 后验证预期行为。
注意:CTS 测试仅在兼容性 WAL 模式停用的情况下才会通过。