应用的兼容性 WAL(预写日志记录)

Android 9 引入了 SQLiteDatabase 的一种特殊模式,称为“兼容性 WAL(预写日志记录)”,它允许数据库使用 journal_mode=WAL,同时保留每个数据库最多创建一个连接的行为。

默认情况下,系统会为应用的数据库启用兼容性 WAL,除非应用已执行以下任一操作:

  1. 通过调用 SQLiteDatabase.enableWriteAheadLoggingdisableWriteAheadLogging 启用或停用了预写日志记录
  2. 通过调用以下内容明确请求了 journal 模式:SQLiteDatabase.OpenParams.setJournalMode(String mode)

启用 WAL journal 模式可显著提升性能并减少写入量。例如,在 ext4 文件系统中,WAL 可将写入速度提高 4 倍。

兼容性 WAL 默认处于启用状态,且无需任何额外的实现操作。

停用兼容性 WAL

要停用兼容性 WAL 模式,请覆盖 db_compatibility_wal_supported 配置资源。

例如:

<bool name="db_compatibility_wal_supported">false</bool>

如果对于某些配置而言,WAL journal 模式的性能与原有回滚 journal 模式相比没有提升,您可能想为这种配置停用兼容性 WAL。例如,在 F2FS 文件系统中,虽然 SQLite 支持原子写入且 DELETE journal 性能与 WAL 类似,但 WAL 可以将写入量提高 10% 到 15%。

验证

要验证兼容性 WAL 模式,请从 CtsDatabaseTestCases 模块运行 CTS 测试。CTS 测试将在启用兼容性 WAL 后验证预期行为。