HarmonyOS 应用开发之关系型数据库跨设备数据同步

场景介绍

当应用程序本地存储的关系型数据存在跨设备同步的需求时，可以将需要同步的表数据迁移到新的支持跨设备的表中，当然也可以在刚完成表创建时设置其支持跨设备。

基本概念

关系型数据库跨设备数据同步，支持应用在多设备间同步存储的关系型数据。

• 分布式列表，应用在数据库中新创建表后，可以设置其为分布式表。在查询远程设备数据库时，根据本地表名可以获取指定远程设备的分布式表名。

• 设备之间同步数据，数据同步有两种方式，将数据从本地设备推送到远程设备或将数据从远程设备拉至本地设备。

运作机制

底层通信组件完成设备发现和认证，会通知上层应用程序设备上线。收到设备上线的消息后数据管理服务可以在两个设备之间建立加密的数据传输通道，利用该通道在两个设备之间进行数据同步。

数据跨设备同步机制

业务将数据写入关系型数据库后，向数据管理服务发起同步请求。

数据管理服务从应用沙箱内读取待同步数据，根据对端设备的deviceId将数据发送到其他设备的数据管理服务。再由数据管理服务将数据写入同应用的数据库内。

数据变化通知机制

增、删、改数据库时，会给订阅者发送数据变化的通知。主要分为本地数据变化通知和分布式数据变化通知。

• 本地数据变化通知：本地设备的应用内订阅数据变化通知，数据库增删改数据时，会收到通知。

• 分布式数据变化通知：同一应用订阅组网内其他设备数据变化的通知，其他设备增删改数据时，本设备会收到通知。

约束限制

• 每个应用程序最多支持同时打开16个关系型分布式数据库。

• 单个数据库最多支持注册8个订阅数据变化的回调。

接口说明

以下是关系型设备协同分布式数据库跨设备数据同步功能的相关接口，大部分为异步接口。异步接口均有callback和Promise两种返回形式，下表均以callback形式为例。

接口名称	描述
setDistributedTables(tables: Array<string>, callback: AsyncCallback<void>): void	设置分布式同步表。
sync(mode: SyncMode, predicates: RdbPredicates, callback: AsyncCallback<Array<[string, number]>>): void	分布式数据同步。
on(event: ‘dataChange’, type: SubscribeType, observer: Callback<Array<string>>): void	订阅分布式数据变化。
off(event:‘dataChange’, type: SubscribeType, observer: Callback<Array<string>>): void	取消订阅分布式数据变化。
obtainDistributedTableName(device: string, table: string, callback: AsyncCallback<string>): void;	根据本地数据库表名获取指定设备上的表名。
remoteQuery(device: string, table: string, predicates: RdbPredicates, columns: Array<string> , callback: AsyncCallback<ResultSet>): void	根据指定条件查询远程设备数据库中的数据。

开发步骤

说明：

数据只允许向数据安全标签不高于对端设备安全等级的设备同步数据，具体规则可见跨设备同步访问控制机制。

1. 导入模块。

   import relationalStore from '@ohos.data.relationalStore';

2. 请求权限。

   1. 需要申请ohos.permission.DISTRIBUTED_DATASYNC权限。
   2. 同时需要在应用首次启动时弹窗向用户申请授权。

3. 创建关系型数据库，设置将需要进行分布式同步的表。

   import UIAbility from '@ohos.app.ability.UIAbility';
   import window from '@ohos.window';
   import {
         BusinessError } from "@ohos.base";
   
   class EntryAbility extends UIAbility {
        
     onWindowStageCreate(windowStage: window.WindowStage) {
        
       const STORE_CONFIG: relationalStore.StoreConfig = {
        
         name: "RdbTest.db",
         securityLevel: relationalStore.SecurityLevel.S1
       };
          
       relationalStore.getRdbStore(this.context, STORE_CONFIG, (err: BusinessError, store: relationalStore.RdbStore) => {
        
         store.