鸿蒙开发入坑篇（九）：本地数据库 (RDB) 深度解析

Facechat2026-02-02 10:14

🔗 项目地址 ：https://github.com/briefness/HarmonyDemo
更新说明 ：本文将介绍 RDB 的 API，以及 SQLite 底层的 B-Tree 索引 和 WAL 机制。

一、理论基础：数据库为什么快？

1.1 B-Tree 索引

为什么在百万条数据中查询 ID 只需要几毫秒？

因为 RDB (基于 SQLite) 使用 B-Tree 结构存储索引。
key < 50
key >= 50
1-25
26-49
50-75
76-100
根节点
子节点 A
子节点 B
数据块 1
数据块 2
数据块 3
数据块 4

它是一种平衡树结构。
查找时间复杂度为 O(log N)。
最佳实践 : 经常作为查询条件的字段（如 userId, createTime），建议创建 Index。

1.2 WAL (Write-Ahead Logging)

SQLite 默认开启 WAL 模式。

原理 : 修改数据时，不直接改原文件 db，而是先追加写入日志文件 db-wal。
优势: 读写完全并发。写操作不会阻塞读操作 (No Locking)。
这保证了后台数据同步时不阻塞 UI 读取。

WAL 文件原始 DB 后台线程 (写) UI 线程 (读) WAL 文件原始 DB 后台线程 (写) UI 线程 (读) 写入快 (顺序 IO) 读取不被阻塞 1. 追加新页 2. 读取旧页 3. 检查点回写 (空闲时)

二、核心概念：谓词 (Predicates)

RdbPredicates 是 SQL WHERE 子句的封装。

typescript 复制代码

// SELECT * FROM TASK WHERE ID = 5 AND DONE = 1
let predicates = new relationalStore.RdbPredicates('TASK');
predicates.equalTo('ID', 5).and().equalTo('DONE', 1);

三、核心 API 流程

3.1 初始化 (init)

typescript 复制代码

const store = await relationalStore.getRdbStore(context, {
  name: 'TaskStore.db',
  securityLevel: relationalStore.SecurityLevel.S1 // 数据安全等级，S1-S4
});

3.2 游标 (ResultSet)

查询返回的 ResultSet 是一个游标，指向数据行的前一行。

注意 : ResultSet 持有资源，使用完毕必须 close()，以免耗尽连接池。

四、常见问题

异步 : RDB 的 I/O 是异步的，必须 await。
Boolean 映射: SQLite 不支持 Boolean，通常使用 Integer (0/1)。
主键自增 : 推荐 ID INTEGER PRIMARY KEY AUTOINCREMENT。

五、总结

掌握 RDB 是处理复杂业务数据的基础。

理解 B-Tree，知道何时建索引。
理解 WAL，知道为什么读写互不干扰。

下一篇，将探讨 状态管理 (State Management) V2 版本的 Proxy 机制。