HarmonyOS数据库入门其实没那么难，十分钟带你快速摸清基础操作和核心要点

综合自华为开发者联盟官方文档、HarmonyOS入门教程社区分享以及部分技术博主的实践经验总结）

你是不是一听到“数据库”这三个字，就觉得头大？觉得那是程序员才需要懂的高深玩意儿？别怕，今天咱们就用十分钟，像唠家常一样，把HarmonyOS里的数据库基础操作和核心要点给你捋清楚，放心,咱不用那些让人犯困的专业术语。

第一分钟：先搞懂HarmonyOS数据库是个啥？

你可以把数据库想象成你手机里的一个超级智能的“小本本”，你的应用需要记住一些东西，比如用户的昵称、设置、或者一篇没写完的日记，总不能每次都让用户重新输入吧？这时候，就需要把这个信息写进“小本本”里存起来，等下次需要的时候，再从这个“小本本”里翻出来，HarmonyOS提供的这个“小本本”，就是它的数据管理能力，具体到本地存储，一个核心角色就是关系型数据库（基于SQLite）。

第二到四分钟：上手前的准备工作——认识“表格”和“钥匙”

在往“小本本”里写东西之前，咱们得先规定一下格式，不然就乱套了,这就要提到两个关键概念：

1. 对象关系映射（ORM）： 这是个听起来高级但其实很简单的帮手。（来源：华为开发者文档中关于@Database注解的说明）你不用自己去写复杂的SQL命令，HarmonyOS推荐的方式是使用ORM，简单理解就是，你定义一个普通的Java/Kotlin类（在HarmonyOS里是Ability或ExtensionAbility），这个类的每个属性，比如userId, userName，就对应着数据库表格里的一列，ORM工具（比如@Entity注解）会自动帮你把这个类和数据库表关联起来,你就当是在画一个表格的模板。
2. 主键（Primary Key）： （来源：数据库基础概念）想象一下，你的“小本本”里记了很多条信息，怎么快速找到其中一条呢？你得给每条信息一个独一无二的“编号”，这个编号就是主键，通常我们用@PrimaryKey注解一个自增的ID字段，这样每存入一条新数据，系统就会自动给它分配一个不重复的号码,像身份证号一样。

第五到七分钟：核心四步走——增删改查

准备工作做完，就可以开始最重要的操作了，所有对数据库的操作，无外乎就是这四种，江湖人称“CRUD”：

1. 增（Create）： 就是往数据库里添加新数据，比如用户注册了一个新账号，你就需要创建一个新的“用户”对象，然后通过数据库操作接口（比如RdbStore的insert方法）把它存进去，这就好比你在“小本本”上新翻开一页,记录下这个用户的信息。
2. 查（Retrieve）： 这是最常用的操作，比如应用一打开，要显示当前登录的用户名，你就需要根据用户的ID（那个主键）去数据库里把这条数据“查”出来。（来源：HarmonyOS API文档中关于RdbPredicates的查询示例）你会用到查询构建器（如RdbPredicates）来设置查询条件，找到那个ID等于123的用户”，然后执行查询,结果会以一个列表的形式返回给你。
3. 改（Update）： 用户修改了昵称，你就需要更新数据库里对应的那条数据，通过update方法，指定要更新哪条数据（通常用主键定位），以及新的值是什么，就像你在“小本本”上找到那条记录，用橡皮擦掉旧名字,写上新名字。
4. 删（Delete）： 用户想要注销账号，或者想清空缓存，你就需要删除数据，用delete方法，根据条件（比如主键）删除指定的数据，相当于把“小本本”上那一页撕掉。

第八分钟：记住两个关键点——连接和线程安全

1. 获取数据库连接： （来源：HarmonyOS开发指南）你的应用在操作数据库之前，必须先获得一个数据库的“操作手柄”，这个手柄就是RdbStore对象，你需要在应用初始化的时候，通过一个辅助类（RdbOpenCallback）来创建或打开数据库，并拿到这个手柄，后面所有的增删改查,都要通过这个手柄来进行。
2. 别在主线程操作： （来源：HarmonyOS性能优化建议）这是一个非常重要的注意事项！数据库操作（尤其是复杂或大量的操作）可能会比较耗时，如果你把它放在主线程（UI线程）里做，界面就会“卡住”，用户会感觉应用卡顿了，务必要把数据库操作放到子线程（比如使用TaskDispatcher）中去执行，操作完成后再回到主线程更新界面,这是保证应用流畅的关键。

第九分钟：实际感受一下——举个极简的例子

假设我们要做一个记事本应用,存一篇篇笔记。

• 定义“笔记”实体： 我们先画个模板，定义一个Note类，里面有id（主键，自增）、title）、content）这几个属性，并加上@Entity注解。
• 用户新建笔记： 点击保存按钮后，在子线程里，我们创建一个Note对象，填好标题和内容，然后调用insert方法,这个笔记就被存进数据库了。
• 打开应用列表显示： 应用启动时，在子线程里执行一个“查询所有笔记”的操作，然后把查到的笔记列表返回给主线程,显示在屏幕上。

第十分钟：总结与下一步

看，是不是没那么难？HarmonyOS数据库入门,你只需要记住：

• 核心思想： 把它当成一个结构化的智能记事本。
• 关键工具： 用ORM（@Entity）来定义你的数据模板。
• 基本操作： 牢牢掌握增、删、改、查这四种动作。
• 注意事项： 操作前拿好“手柄”（RdbStore），操作时“别挡路”（放子线程）。

摸清了这些基础，你就已经成功入门了，如果你想深入，可以去华为开发者官网看看更详细的文档，学习一下复杂查询、数据库升级迁移等进阶知识，但无论如何，今天这十分钟帮你打下的基础，已经足够你开始动手做一些有趣的小应用了！大胆去试试吧！