# 单版本分布式数据库 >![](../../public_sys-resources/icon-note.gif) **说明:** >从 API Version 7 开始支持。 ## 导入模块 ``` import factory from '@ohos.data.distributeddata'; ``` ## 权限 无 ## SingleKVStore 单版本分布式数据库,继承自分布式数据库,支持查询、同步数据,也具备分布式数据库的所有的接口能力。需要先通过[getKVStore](js-apis-data-kvmanager.md#zh-cn_topic_0000001179090937_section51960467216)获取实例。 ### get\(key: string, callback: AsyncCallback\): void 获取指定键的值。 此方法为异步callback方法。 - 参数:

参数名

类型

说明

key

string

要查询数据的key。不能为空且长度不大于1KB

callback

AsyncCallback<Uint8Array | string | boolean | number>

回调函数,获取查询的值。

- 返回值: 无 - 示例: ``` kvStore.get('key-001', function(err, value){ console.info(value); }); ``` ### get\(key: string\): Promise 获取指定键的值。 此方法为异步promise方法。 - 参数:

参数名

类型

说明

key

string

要查询数据的key。不能为空且长度不大于1KB

- 返回值:

类型

说明

Promise<Uint8Array | string | boolean | number>

promise实例,用于获取异步返回结果。

- 示例: ``` const promise = kvStore.get('key-001'); promise.then((data) => { console.info(value); }).catch((err) => { }); ``` ### sync\(deviceIdList: string\[\], mode: SyncMode, allowedDelayMs?: number\): void 在手动模式下,触发数据库同步。 此方法为同步方法。 - 参数:

参数名

类型

必填

说明

deviceIdList

string[]

同一组网环境下,需要同步的设备networkid列表。

mode

SyncMode

同步类型。

0:PUSH_ONLY, 1: PULL_ONLY, 2: PUSH_PULL

allowedDelayMs

number

可选参数。允许延时时间,单位毫秒。

- 返回值: 无 - 示例: ``` kvStore.sync(deviceIds, 1, 1000); ```