【Harmony OS】数据存储

数据存储概述

• 数据存储是为了解决应用数据持久化问题，使得数据能够存储在外存中，达到保存或共享目的。
• 鸿蒙应用数据存储包括本地数据存储和分布式数据存储。
• 本地数据存储为应用提供了单设备上数据存储和访问能力。
• HarmonyOS支持文件存储，并在此基础上提供了基于文件的首选项数据存储。HarmonyOS底层采用SQLite数据库管理系统作为持久化存储引擎，为应用提供关系型数据存储。
• 分布式数据存储支持跨设备之间的数据共享和同步等。
• 鸿蒙分布式数据服务为应用程序提供了不同设备间数据库数据分布存储能力。方便应用程序数据在不同终端设备间的无缝衔接。分布式数据存储是鸿蒙系统的特色之一。

首选项数据存储

• 首选项数据存储也称为偏好数据存储或轻量级数据存储，适合于少量的数据存储，如：登录账户密码、配置信息等。
• 首选项数据存储具有访问速度快，存取效率高的特点。
• 首选项数据存储数据最终是存储在操作系统的文件中的，系统提供对底层文件读写的封装，并把底层文件映射成
Preferences实例对象。
• 首选项数据库存储的访问机制，每一个底层文件对应一个Preferences实例，应用可以借助Preferences提供的接口方法，进行读写数据

• 首选项数据存储采用的是键值对（Key-Value）结构，同一个键在存储文件中只会对应一个值
• Key为String类型，且长度为不超过 1024个字节
• 值的类型： number | string | boolean |
Array<number> | Array<string> | Array<boolean>
| Uint8Array | object | bigint
• 数据量应该是轻量级的，建议存储的数据不超过一万条
• 不支持在多进程场景下使用

关系型数据库

• 关系型数据库（Relational Database，RDB）是基于关系模型组织管理数据的数据库。关系型数据库中一般包含若干个二维的数据表，每个表中以行和列的形式存储数据。
• 鸿蒙关系型数据存储底层使用SQLite 作为持久化存储引擎，支持SQLite的所有数据库特性，包括事务、索引、视图、触发器、外键、参数化查询和预编译SQL语句等。
• 鸿蒙关系型数据存储框架实现了对底层SQLite数据进一步封装，对上层提供通用、完善且高效操作接口，包括一系列的增、删、改、查等。

复制代码

// 定义配置
const options: distributedKVStore.Options = {
createIfMissing: true,
encr ypt: false,
backup: false,
autoSync: false,
// kvStoreType不填时，默认创建多设备协同数据库
kvStoreType: 
distributedKVStore.KVStoreType.SINGLE_VERSION,
// 多设备协同数据库：kvStoreType: 
distributedKVStore.KVStoreType.DEVICE_COLLABORATION,
securityLevel: distributedKVStore.SecurityLevel.S1
};

kvManager?.getKVStore<distributedKVStore.SingleKVStore> ('
storeId', options,
(err, store: distributedKVStore.SingleKVStore ) => {
if (err ) {
console.error (`Failed to get KVStore: 
Code:$ {err.code },message:${err.message }`);
return;
}
console.info('Succeeded in getting KVStore.');
this.kvStore = store;
// 请确保获取到键值数据库实例后，再进行相关数据操作
// put、get、delete......方法
});