分布式键值数据库

2024-01-23 16:06 更新

分布式键值数据库为应用程序提供不同设备间数据库的分布式协同能力。通过调用分布式键值数据库各个接口,应用程序可将数据保存到分布式键值数据库中,并可对分布式键值数据库中的数据进行增加、删除、修改、查询等操作。

该模块提供以下分布式键值数据库相关的常用功能:

  • KVManager:分布式键值数据库管理实例,用于获取数据库的相关信息。
  • KVStoreResultSet:提供获取数据库结果集的相关方法,包括查询和移动数据读取位置等。
  • Query:使用谓词表示数据库查询,提供创建Query实例、查询数据库中的数据和添加谓词的方法。
  • SingleKVStore:单版本分布式键值数据库,不对数据所属设备进行区分,提供查询数据的方法。
  • DeviceKVStore:设备协同数据库,继承自SingleKVStore,以设备维度对数据进行区分,提供查询数据的方法。
说明

本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

分布式键值数据库当前仅支持本地功能,分布式功能暂不支持。

导入模块

  1. import distributedKVStore from '@ohos.data.distributedKVStore';

KVManagerConfig

提供KVManager实例的配置信息,包括调用方的包名和应用的上下文。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

名称

类型

必填

说明

context

Context

应用的上下文。

FA模型的应用Context定义见Context

Stage模型的应用Context定义见Context

bundleName

string

调用方的包名。

Constants

分布式键值数据库常量。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

名称

说明

MAX_KEY_LENGTH

1024

数据库中Key允许的最大长度,单位字节。

MAX_VALUE_LENGTH

4194303

数据库中Value允许的最大长度,单位字节。

MAX_KEY_LENGTH_DEVICE

896

设备协同数据库中key允许的最大长度,单位字节。

MAX_STORE_ID_LENGTH

128

数据库标识符允许的最大长度,单位字节。

MAX_QUERY_LENGTH

512000

最大查询长度,单位字节。

MAX_BATCH_SIZE

128

最大批处理操作数量。

ValueType

数据类型枚举。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

名称

说明

STRING

表示值类型为字符串。

INTEGER

表示值类型为整数。

FLOAT

表示值类型为浮点数。

BYTE_ARRAY

表示值类型为字节数组。

BOOLEAN

表示值类型为布尔值。

DOUBLE

表示值类型为双浮点数。

Value

存储在数据库中的值对象。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

名称

类型

必填

说明

type

ValueType

值类型。

value

Uint8Array | string | number | boolean

值。

Entry

存储在数据库中的键值对。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

名称

类型

必填

说明

key

string

键值。

value

Value

值对象。

ChangeNotification

数据变更时通知的对象,包括数据插入的数据、更新的数据、删除的数据和设备ID。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

名称

类型

必填

说明

insertEntries

Entry[]

数据添加记录。

updateEntries

Entry[]

数据更新记录。

deleteEntries

Entry[]

数据删除记录。

deviceId

string

设备ID,此处为设备UUID。

SyncMode

同步模式枚举。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

名称

说明

PULL_ONLY

表示只能从远端拉取数据到本端。

PUSH_ONLY

表示只能从本端推送数据到远端。

PUSH_PULL

表示从本端推送数据到远端,然后从远端拉取数据到本端。

SubscribeType

订阅类型枚举。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

名称

说明

SUBSCRIBE_TYPE_LOCAL

表示订阅本地数据变更。

SUBSCRIBE_TYPE_REMOTE

表示订阅远端数据变更。

此接口能力在HarmonyOS 3.1Release暂不支持。

SUBSCRIBE_TYPE_ALL

表示订阅远端和本地数据变更。

此接口能力在HarmonyOS 3.1Release暂不支持。

KVStoreType

分布式键值数据库类型枚举。

名称

说明

DEVICE_COLLABORATION

表示多设备协同数据库。

数据库特点: 数据以设备的维度管理,不存在冲突;支持按照设备的维度查询数据。

系统能力: SystemCapability.DistributedDataManager.KVStore.DistributedKVStore

SINGLE_VERSION

表示单版本数据库。

数据库特点: 数据不分设备,设备之间修改相同的key会覆盖。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

SecurityLevel

数据库的安全级别枚举。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

名称

说明

S1

表示数据库的安全级别为低级别,数据的泄露、篡改、破坏、销毁可能会给个人或组织导致有限的不利影响。

例如,性别、国籍,用户申请记录等。

S2

表示数据库的安全级别为中级别,数据的泄露、篡改、破坏、销毁可能会给个人或组织导致严重的不利影响。

例如,个人详细通信地址,姓名昵称等。

S3

表示数据库的安全级别为高级别,数据的泄露、篡改、破坏、销毁可能会给个人或组织导致严峻的不利影响。

例如,个人实时精确定位信息、运动轨迹等。

S4

表示数据库的安全级别为关键级别,业界法律法规中定义的特殊数据类型,涉及个人的最私密领域的信息或者一旦泄露、篡改、破坏、销毁可能会给个人或组织造成重大的不利影响数据。

例如,政治观点、宗教、和哲学信仰、工会成员资格、基因数据、生物信息、健康和性生活状况、性取向等或设备认证鉴权、个人的信用卡等财务信息。

Options

用于提供创建数据库的配置信息。

名称

类型

必填

说明

createIfMissing

boolean

当数据库文件不存在时是否创建数据库,默认为true,即创建。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

encrypt

boolean

设置数据库文件是否加密,默认为false,即不加密。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

backup

boolean

设置数据库文件是否备份,默认为true,即备份。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

autoSync

boolean

设置数据库文件是否自动同步。默认为false,即手动同步;设置为true时,表示自动同步。

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

需要权限: ohos.permission.DISTRIBUTED_DATASYNC

kvStoreType

KVStoreType

设置要创建的数据库类型,默认为DEVICE_COLLABORATION,即多设备协同数据库。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

securityLevel

SecurityLevel

设置数据库安全级别。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

schema

Schema

设置定义存储在数据库中的值,默认为undefined,即不使用Schema。

系统能力: SystemCapability.DistributedDataManager.KVStore.DistributedKVStore

Schema

表示数据库模式,可以在创建或打开数据库时创建Schema对象并将它们放入Options中。

系统能力: SystemCapability.DistributedDataManager.KVStore.DistributedKVStore

名称

类型

可读

可写

说明

root

FieldNode

表示json根对象。

indexes

Array<string>

表示json类型的字符串数组。

mode

number

表示Schema的模式。

skip

number

Schema的跳跃大小。

constructor

constructor()

用于创建Schema实例的构造函数。

系统能力: SystemCapability.DistributedDataManager.KVStore.DistributedKVStore

FieldNode

表示 Schema 实例的节点,提供定义存储在数据库中的值的方法。

系统能力: SystemCapability.DistributedDataManager.KVStore.DistributedKVStore

名称

类型

可读

可写

说明

nullable

boolean

表示数据库字段是否可以为空。

default

string

表示Fieldnode的默认值。

type

number

表示指定节点对应数据类型的值。

constructor

constructor(name: string)

用于创建带有string字段FieldNode实例的构造函数。

系统能力: SystemCapability.DistributedDataManager.KVStore.DistributedKVStore

参数:

参数名

类型

必填

说明

name

string

FieldNode的值。

appendChild

appendChild(child: FieldNode): boolean

在当前 FieldNode 中添加一个子节点。

系统能力: SystemCapability.DistributedDataManager.KVStore.DistributedKVStore

参数:

参数名

类型

必填

说明

child

FieldNode

要附加的域节点。

返回值:

类型

说明

boolean

返回true表示子节点成功添加到FieldNode;返回false则表示操作失败。

示例:

  1. try {
  2. let node = new distributedKVStore.FieldNode("root");
  3. let child1 = new distributedKVStore.FieldNode("child1");
  4. let child2 = new distributedKVStore.FieldNode("child2");
  5. let child3 = new distributedKVStore.FieldNode("child3");
  6. node.appendChild(child1);
  7. node.appendChild(child2);
  8. node.appendChild(child3);
  9. console.info("appendNode " + JSON.stringify(node));
  10. child1 = null;
  11. child2 = null;
  12. child3 = null;
  13. node = null;
  14. } catch (e) {
  15. console.error("AppendChild " + e);
  16. }

distributedKVStore.createKVManager

createKVManager(config: KVManagerConfig): KVManager

创建一个KVManager对象实例,用于管理数据库对象。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

config

KVManagerConfig

提供KVManager实例的配置信息,包括调用方的包名和用户信息。

返回值:

类型

说明

KVManager

返回创建的KVManager对象实例。

示例:

Stage模型下的示例:

  1. import UIAbility from '@ohos.app.ability.UIAbility';
  2. let kvManager;
  3. export default class EntryAbility extends UIAbility {
  4. onCreate() {
  5. console.info("MyAbilityStage onCreate")
  6. let context = this.context
  7. const kvManagerConfig = {
  8. context: context,
  9. bundleName: 'com.example.datamanagertest',
  10. }
  11. try {
  12. kvManager = distributedKVStore.createKVManager(kvManagerConfig);
  13. console.info("Succeeded in creating KVManager");
  14. } catch (e) {
  15. console.error(`Failed to create KVManager.code is ${e.code},message is ${e.message}`);
  16. }
  17. }
  18. }

FA模型下的示例:

  1. import featureAbility from '@ohos.ability.featureAbility';
  2. let kvManager;
  3. let context = featureAbility.getContext()
  4. const kvManagerConfig = {
  5. context: context,
  6. bundleName: 'com.example.datamanagertest',
  7. }
  8. try {
  9. kvManager = distributedKVStore.createKVManager(kvManagerConfig);
  10. console.info("Succeeded in creating KVManager");
  11. } catch (e) {
  12. console.error(`Failed to create KVManager.code is ${e.code},message is ${e.message}`);
  13. }

KVManager

分布式键值数据库管理实例,用于获取分布式键值数据库的相关信息。在调用KVManager的方法前,需要先通过createKVManager构建一个KVManager实例。

getKVStore

getKVStore<T>(storeId: string, options: Options, callback: AsyncCallback<T>): void

通过指定Options和storeId,创建并获取分布式键值数据库,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

storeId

string

数据库唯一标识符,长度不大于MAX_STORE_ID_LENGTH

options

Options

创建分布式键值实例的配置信息。

callback

AsyncCallback<T>

回调函数。返回创建的分布式键值数据库实例(根据kvStoreType的不同,可以创建SingleKVStore实例和DeviceKVStore实例)。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100002

Open existed database with changed options.

15100003

Database corrupted.

示例:

  1. let kvStore;
  2. try {
  3. const options = {
  4. createIfMissing: true,
  5. encrypt: false,
  6. backup: false,
  7. autoSync: true,
  8. kvStoreType: distributedKVStore.KVStoreType.SINGLE_VERSION,
  9. securityLevel: distributedKVStore.SecurityLevel.S2,
  10. };
  11. kvManager.getKVStore('storeId', options, function (err, store) {
  12. if (err) {
  13. console.error(`Failed to get KVStore.code is ${err.code},message is ${err.message}`);
  14. return;
  15. }
  16. console.info("Succeeded in getting KVStore");
  17. kvStore = store;
  18. });
  19. } catch (e) {
  20. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  21. }

getKVStore

getKVStore<T>(storeId: string, options: Options): Promise<T>

通过指定Options和storeId,创建并获取分布式键值数据库,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

storeId

string

数据库唯一标识符,长度不大于MAX_STORE_ID_LENGTH

options

Options

创建分布式键值实例的配置信息。

返回值:

类型

说明

Promise<T>

Promise对象。返回创建的分布式键值数据库实例(根据kvStoreType的不同,可以创建SingleKVStore实例和DeviceKVStore实例。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100002

Open existed database with changed options.

15100003

Database corrupted.

示例:

  1. let kvStore;
  2. try {
  3. const options = {
  4. createIfMissing: true,
  5. encrypt: false,
  6. backup: false,
  7. autoSync: true,
  8. kvStoreType: distributedKVStore.KVStoreType.SINGLE_VERSION,
  9. securityLevel: distributedKVStore.SecurityLevel.S2,
  10. };
  11. kvManager.getKVStore('storeId', options).then((store) => {
  12. console.info("Succeeded in getting KVStore");
  13. kvStore = store;
  14. }).catch((err) => {
  15. console.error(`Failed to get KVStore.code is ${err.code},message is ${err.message}`);
  16. });
  17. } catch (e) {
  18. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  19. }

closeKVStore

closeKVStore(appId: string, storeId: string, callback: AsyncCallback<void>): void

通过storeId的值关闭指定的分布式键值数据库,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

appId

string

所调用数据库方的包名。

storeId

string

要关闭的数据库唯一标识符,长度不大于MAX_STORE_ID_LENGTH

callback

AsyncCallback<void>

回调函数。

示例:

  1. const options = {
  2. createIfMissing: true,
  3. encrypt: false,
  4. backup: false,
  5. autoSync: true,
  6. kvStoreType: distributedKVStore.KVStoreType.SINGLE_VERSION,
  7. schema: undefined,
  8. securityLevel: distributedKVStore.SecurityLevel.S2,
  9. }
  10. try {
  11. kvManager.getKVStore('storeId', options, async function (err, store) {
  12. if (err != undefined) {
  13. console.error(`Failed to get KVStore.code is ${err.code},message is ${err.message}`);
  14. return;
  15. }
  16. console.info('Succeeded in getting KVStore');
  17. kvStore = store;
  18. kvStore = null;
  19. store = null;
  20. kvManager.closeKVStore('appId', 'storeId', function (err) {
  21. if (err != undefined) {
  22. console.error(`Failed to close KVStore.code is ${err.code},message is ${err.message}`);
  23. return;
  24. }
  25. console.info('Succeeded in closing KVStore');
  26. });
  27. });
  28. } catch (e) {
  29. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  30. }

closeKVStore

closeKVStore(appId: string, storeId: string): Promise<void>

通过storeId的值关闭指定的分布式键值数据库,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

appId

string

所调用数据库方的包名。

storeId

string

要关闭的数据库唯一标识符,长度不大于MAX_STORE_ID_LENGTH

返回值:

类型

说明

Promise<void>

无返回结果的Promise对象。

示例:

  1. const options = {
  2. createIfMissing: true,
  3. encrypt: false,
  4. backup: false,
  5. autoSync: true,
  6. kvStoreType: distributedKVStore.KVStoreType.SINGLE_VERSION,
  7. schema: undefined,
  8. securityLevel: distributedKVStore.SecurityLevel.S2,
  9. }
  10. try {
  11. kvManager.getKVStore('storeId', options).then(async (store) => {
  12. console.info('Succeeded in getting KVStore');
  13. kvStore = store;
  14. kvStore = null;
  15. store = null;
  16. kvManager.closeKVStore('appId', 'storeId').then(() => {
  17. console.info('Succeeded in closing KVStore');
  18. }).catch((err) => {
  19. console.error(`Failed to close KVStore.code is ${err.code},message is ${err.message}`);
  20. });
  21. }).catch((err) => {
  22. console.error(`Failed to get KVStore.code is ${err.code},message is ${err.message}`);
  23. });
  24. } catch (e) {
  25. console.error(`Failed to close KVStore.code is ${e.code},message is ${e.message}`);
  26. }

deleteKVStore

deleteKVStore(appId: string, storeId: string, callback: AsyncCallback<void>): void

通过storeId的值删除指定的分布式键值数据库,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

appId

string

所调用数据库方的包名。

storeId

string

要删除的数据库唯一标识符,长度不大于MAX_STORE_ID_LENGTH

callback

AsyncCallback<void>

回调函数。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100004

Not found.

示例:

  1. const options = {
  2. createIfMissing: true,
  3. encrypt: false,
  4. backup: false,
  5. autoSync: true,
  6. kvStoreType: distributedKVStore.KVStoreType.SINGLE_VERSION,
  7. schema: undefined,
  8. securityLevel: distributedKVStore.SecurityLevel.S2,
  9. }
  10. try {
  11. kvManager.getKVStore('store', options, async function (err, store) {
  12. if (err != undefined) {
  13. console.error(`Failed to get KVStore.code is ${err.code},message is ${err.message}`);
  14. return;
  15. }
  16. console.info('Succeeded in getting KVStore');
  17. kvStore = store;
  18. kvStore = null;
  19. store = null;
  20. kvManager.deleteKVStore('appId', 'storeId', function (err) {
  21. if (err != undefined) {
  22. console.error(`Failed to delete KVStore.code is ${err.code},message is ${err.message}`);
  23. return;
  24. }
  25. console.info(`Succeeded in deleting KVStore`);
  26. });
  27. });
  28. } catch (e) {
  29. console.error(`Failed to delete KVStore.code is ${e.code},message is ${e.message}`);
  30. }

deleteKVStore

deleteKVStore(appId: string, storeId: string): Promise<void>

通过storeId的值删除指定的分布式键值数据库,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

appId

string

所调用数据库方的包名。

storeId

string

要删除的数据库唯一标识符,长度不大于MAX_STORE_ID_LENGTH

返回值:

类型

说明

Promise<void>

无返回结果的Promise对象。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100004

Not found.

示例:

  1. const options = {
  2. createIfMissing: true,
  3. encrypt: false,
  4. backup: false,
  5. autoSync: true,
  6. kvStoreType: distributedKVStore.KVStoreType.SINGLE_VERSION,
  7. schema: undefined,
  8. securityLevel: distributedKVStore.SecurityLevel.S2,
  9. }
  10. try {
  11. kvManager.getKVStore('storeId', options).then(async (store) => {
  12. console.info('Succeeded in getting KVStore');
  13. kvStore = store;
  14. kvStore = null;
  15. store = null;
  16. kvManager.deleteKVStore('appId', 'storeId').then(() => {
  17. console.info('Succeeded in deleting KVStore');
  18. }).catch((err) => {
  19. console.error(`Failed to delete KVStore.code is ${err.code},message is ${err.message}`);
  20. });
  21. }).catch((err) => {
  22. console.error(`Failed to get KVStore.code is ${err.code},message is ${err.message}`);
  23. });
  24. } catch (e) {
  25. console.error(`Failed to delete KVStore.code is ${e.code},message is ${e.message}`);
  26. }

getAllKVStoreId

getAllKVStoreId(appId: string, callback: AsyncCallback<string[]>): void

获取所有通过getKVStore方法创建的且没有调用deleteKVStore方法删除的分布式键值数据库的storeId,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

appId

string

所调用数据库方的包名。

callback

AsyncCallback<string[]>

回调函数。返回所有创建的分布式键值数据库的storeId。

示例:

  1. try {
  2. kvManager.getAllKVStoreId('appId', function (err, data) {
  3. if (err != undefined) {
  4. console.error(`Failed to get AllKVStoreId.code is ${err.code},message is ${err.message}`);
  5. return;
  6. }
  7. console.info('Succeeded in getting AllKVStoreId');
  8. console.info(`GetAllKVStoreId size = ${data.length}`);
  9. });
  10. } catch (e) {
  11. console.error(`Failed to get AllKVStoreId.code is ${e.code},message is ${e.message}`);
  12. }

getAllKVStoreId

getAllKVStoreId(appId: string): Promise<string[]>

获取所有通过getKVStore方法创建的且没有调用deleteKVStore方法删除的分布式键值数据库的storeId,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

appId

string

所调用数据库方的包名。

返回值:

类型

说明

Promise<string[]>

Promise对象。返回所有创建的分布式键值数据库的storeId。

示例:

  1. try {
  2. console.info('GetAllKVStoreId');
  3. kvManager.getAllKVStoreId('appId').then((data) => {
  4. console.info('Succeeded in getting AllKVStoreId');
  5. console.info(`GetAllKVStoreId size = ${data.length}`);
  6. }).catch((err) => {
  7. console.error(`Failed to get AllKVStoreId.code is ${err.code},message is ${err.message}`);
  8. });
  9. } catch (e) {
  10. console.error(`Failed to get AllKVStoreId.code is ${e.code},message is ${e.message}`);
  11. }

on('distributedDataServiceDie')

on(event: 'distributedDataServiceDie', deathCallback: Callback<void>): void

订阅服务状态变更通知。如果服务终止,需要重新注册数据变更通知和同步完成事件回调通知,并且同步操作会返回失败。

系统能力: SystemCapability.DistributedDataManager.KVStore.DistributedKVStore

参数:

参数名

类型

必填

说明

event

string

订阅的事件名,固定为'distributedDataServiceDie',即服务状态变更事件。

deathCallback

Callback<void>

回调函数。

示例:

  1. try {
  2. console.info('KVManagerOn');
  3. const deathCallback = function () {
  4. console.info('death callback call');
  5. }
  6. kvManager.on('distributedDataServiceDie', deathCallback);
  7. } catch (e) {
  8. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  9. }

off('distributedDataServiceDie')

off(event: 'distributedDataServiceDie', deathCallback?: Callback<void>): void

取消订阅服务状态变更通知。参数中的deathCallback必须是已经订阅过的deathCallback,否则会取消订阅失败。

系统能力: SystemCapability.DistributedDataManager.KVStore.DistributedKVStore

参数:

参数名

类型

必填

说明

event

string

取消订阅的事件名,固定为'distributedDataServiceDie',即服务状态变更事件。

deathCallback

Callback<void>

回调函数。如果该参数不填,那么会将之前订阅过的所有的deathCallback取消订阅。

示例:

  1. try {
  2. console.info('KVManagerOff');
  3. const deathCallback = function () {
  4. console.info('death callback call');
  5. }
  6. kvManager.off('distributedDataServiceDie', deathCallback);
  7. } catch (e) {
  8. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  9. }

KVStoreResultSet

提供获取数据库结果集的相关方法,包括查询和移动数据读取位置等。同时允许打开的结果集的最大数量为8个。

在调用KVStoreResultSet的方法前,需要先通过getKVStore构建一个SingleKVStore或者DeviceKVStore实例。

getCount

getCount(): number

获取结果集中的总行数。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

返回值:

类型

说明

number

返回数据的总行数。

示例:

  1. try {
  2. let resultSet;
  3. let count;
  4. kvStore.getResultSet('batch_test_string_key').then((result) => {
  5. console.info('getResultSet succeed.');
  6. resultSet = result;
  7. count = resultSet.getCount();
  8. console.info("getCount succeed:" + count);
  9. }).catch((err) => {
  10. console.error('getResultSet failed: ' + err);
  11. });
  12. } catch (e) {
  13. console.error("getCount failed: " + e);
  14. }

getPosition

getPosition(): number

获取结果集中当前的读取位置。读取位置会因moveToFirstmoveToLast等操作而发生变化。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

返回值:

类型

说明

number

返回当前读取位置。取值范围>= -1,值为 -1 时表示还未开始读取,值为 0 时表示第一行。

示例:

  1. try {
  2. let resultSet;
  3. let position;
  4. kvStore.getResultSet('batch_test_string_key').then((result) => {
  5. console.info('getResultSet succeeded.');
  6. resultSet = result;
  7. position = resultSet.getPosition();
  8. console.info("getPosition succeed:" + position);
  9. }).catch((err) => {
  10. console.error('getResultSet failed: ' + err);
  11. });
  12. } catch (e) {
  13. console.error("getPosition failed: " + e);
  14. }

moveToFirst

moveToFirst(): boolean

将读取位置移动到第一行。如果结果集为空,则返回false。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

返回值:

类型

说明

boolean

返回true表示操作成功;返回false则表示操作失败。

示例:

  1. try {
  2. let resultSet;
  3. let moved;
  4. kvStore.getResultSet('batch_test_string_key').then((result) => {
  5. console.info('getResultSet succeed.');
  6. resultSet = result;
  7. moved = resultSet.moveToFirst();
  8. console.info("moveToFirst succeed: " + moved);
  9. }).catch((err) => {
  10. console.error('getResultSet failed: ' + err);
  11. });
  12. } catch (e) {
  13. console.error("moveToFirst failed " + e);
  14. }

moveToLast

moveToLast(): boolean

将读取位置移动到最后一行。如果结果集为空,则返回false。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

返回值:

类型

说明

boolean

返回true表示操作成功;返回false则表示操作失败。

示例:

  1. try {
  2. let resultSet;
  3. let moved;
  4. kvStore.getResultSet('batch_test_string_key').then((result) => {
  5. console.info('getResultSet succeed.');
  6. resultSet = result;
  7. moved = resultSet.moveToLast();
  8. console.info("moveToLast succeed:" + moved);
  9. }).catch((err) => {
  10. console.error('getResultSet failed: ' + err);
  11. });
  12. } catch (e) {
  13. console.error("moveToLast failed: " + e);
  14. }

moveToNext

moveToNext(): boolean

将读取位置移动到下一行。如果结果集为空,则返回false。适用于全量获取数据库结果集的场景。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

返回值:

类型

说明

boolean

返回true表示操作成功;返回false则表示操作失败。

示例:

  1. try {
  2. let resultSet;
  3. let moved;
  4. kvStore.getResultSet('batch_test_string_key').then((result) => {
  5. console.info('getResultSet succeed.');
  6. resultSet = result;
  7. do {
  8. moved = resultSet.moveToNext();
  9. console.info("moveToNext succeed: " + moved);
  10. } while (moved)
  11. }).catch((err) => {
  12. console.error('getResultSet failed: ' + err);
  13. });
  14. } catch (e) {
  15. console.error("moveToNext failed: " + e);
  16. }

moveToPrevious

moveToPrevious(): boolean

将读取位置移动到上一行。如果结果集为空,则返回false。适用于全量获取数据库结果集的场景。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

返回值:

类型

说明

boolean

返回true表示操作成功;返回false则表示操作失败。

示例:

  1. try {
  2. let resultSet;
  3. let moved;
  4. kvStore.getResultSet('batch_test_string_key').then((result) => {
  5. console.info('getResultSet succeed.');
  6. resultSet = result;
  7. moved = resultSet.moveToLast();
  8. moved = resultSet.moveToPrevious();
  9. console.info("moveToPrevious succeed:" + moved);
  10. }).catch((err) => {
  11. console.error('getResultSet failed: ' + err);
  12. });
  13. } catch (e) {
  14. console.error("moveToPrevious failed: " + e);
  15. }

move

move(offset: number): boolean

将读取位置移动到当前位置的相对偏移量。即当前游标位置向下偏移 offset 行。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

offset

number

表示与当前位置的相对偏移量,负偏移表示向后移动,正偏移表示向前移动。

返回值:

类型

说明

boolean

返回true表示操作成功;返回false则表示操作失败。

示例:

  1. try {
  2. let resultSet;
  3. let moved;
  4. kvStore.getResultSet('batch_test_string_key').then((result) => {
  5. console.info('Succeeded in getting resultSet');
  6. resultSet = result;
  7. moved = resultSet.move(2); //若当前位置为0,将读取位置从绝对位置为0的位置移动2行,即移动到绝对位置为2,行数为3的位置
  8. console.info(`Succeeded in moving.moved = ${moved}`);
  9. }).catch((err) => {
  10. console.error(`Failed to get resultSet.code is ${err.code},message is ${err.message}`);
  11. });
  12. } catch (e) {
  13. console.error(`Failed to move.code is ${e.code},message is ${e.message}`);
  14. }

moveToPosition

moveToPosition(position: number): boolean

将读取位置从 0 移动到绝对位置。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

position

number

表示绝对位置。

返回值:

类型

说明

boolean

返回true表示操作成功;返回false则表示操作失败。

示例

  1. try {
  2. let resultSet;
  3. let moved;
  4. kvStore.getResultSet('batch_test_string_key').then((result) => {
  5. console.info('Succeeded in getting resultSet');
  6. resultSet = result;
  7. moved = resultSet.moveToPosition(1);
  8. console.info(`Succeeded in moving to position.moved=${moved}`);
  9. }).catch((err) => {
  10. console.error(`Failed to get resultSet.code is ${err.code},message is ${err.message}`);
  11. });
  12. } catch (e) {
  13. console.error(`Failed to move to position.code is ${e.code},message is ${e.message}`);
  14. }

isFirst

isFirst(): boolean

检查读取位置是否为第一行。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

返回值:

类型

说明

boolean

返回true表示读取位置为第一行;返回false表示读取位置不是第一行。

示例:

  1. try {
  2. let resultSet;
  3. let isfirst;
  4. kvStore.getResultSet('batch_test_string_key').then((result) => {
  5. console.info('getResultSet succeed.');
  6. resultSet = result;
  7. isfirst = resultSet.isFirst();
  8. console.info("Check isFirst succeed:" + isfirst);
  9. }).catch((err) => {
  10. console.error('getResultSet failed: ' + err);
  11. });
  12. } catch (e) {
  13. console.error("Check isFirst failed: " + e);
  14. }

isLast

isLast(): boolean

检查读取位置是否为最后一行。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

返回值:

类型

说明

boolean

返回true表示读取位置为最后一行;返回false表示读取位置不是最后一行。

示例:

  1. try {
  2. let resultSet;
  3. let islast;
  4. kvStore.getResultSet('batch_test_string_key').then((result) => {
  5. console.info('getResultSet succeed.');
  6. resultSet = result;
  7. islast = resultSet.isLast();
  8. console.info("Check isLast succeed: " + islast);
  9. }).catch((err) => {
  10. console.error('getResultSet failed: ' + err);
  11. });
  12. } catch (e) {
  13. console.error("Check isLast failed: " + e);
  14. }

isBeforeFirst

isBeforeFirst(): boolean

检查读取位置是否在第一行之前。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

返回值:

类型

说明

boolean

返回true表示读取位置在第一行之前;返回false表示读取位置不在第一行之前。

示例:

  1. try {
  2. let resultSet;
  3. kvStore.getResultSet('batch_test_string_key').then((result) => {
  4. console.info('getResultSet succeed.');
  5. resultSet = result;
  6. const isbeforefirst = resultSet.isBeforeFirst();
  7. console.info("Check isBeforeFirst succeed: " + isbeforefirst);
  8. }).catch((err) => {
  9. console.error('getResultSet failed: ' + err);
  10. });
  11. } catch (e) {
  12. console.error("Check isBeforeFirst failed: " + e);
  13. }

isAfterLast

isAfterLast(): boolean

检查读取位置是否在最后一行之后。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

返回值:

类型

说明

boolean

返回true表示读取位置在最后一行之后;返回false表示读取位置不在最后一行之后。

示例:

  1. try {
  2. let resultSet;
  3. kvStore.getResultSet('batch_test_string_key').then((result) => {
  4. console.info('getResultSet succeed.');
  5. resultSet = result;
  6. const isafterlast = resultSet.isAfterLast();
  7. console.info("Check isAfterLast succeed:" + isafterlast);
  8. }).catch((err) => {
  9. console.error('getResultSet failed: ' + err);
  10. });
  11. } catch (e) {
  12. console.error("Check isAfterLast failed: " + e);
  13. }

getEntry

getEntry(): Entry

从当前位置获取对应的键值对。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

返回值:

类型

说明

Entry

返回键值对。

示例:

  1. try {
  2. let resultSet;
  3. kvStore.getResultSet('batch_test_string_key').then((result) => {
  4. console.info('getResultSet succeed.');
  5. resultSet = result;
  6. const entry = resultSet.getEntry();
  7. console.info("getEntry succeed:" + JSON.stringify(entry));
  8. }).catch((err) => {
  9. console.error('getResultSet failed: ' + err);
  10. });
  11. } catch (e) {
  12. console.error("getEntry failed: " + e);
  13. }

Query

使用谓词表示数据库查询,提供创建Query实例、查询数据库中的数据和添加谓词的方法。一个Query对象中谓词数量上限为256个。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

constructor

constructor()

用于创建Schema实例的构造函数。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

reset

reset(): Query

重置Query对象。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

返回值:

类型

说明

Query

返回重置的Query对象。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. query.equalTo("key", "value");
  4. console.info("query is " + query.getSqlLike());
  5. query.reset();
  6. console.info("query is " + query.getSqlLike());
  7. query = null;
  8. } catch (e) {
  9. console.error("simply calls should be ok :" + e);
  10. }

equalTo

equalTo(field: string, value: number|string|boolean): Query

构造一个Query对象来查询具有指定字段的条目,其值等于指定的值。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

fieId

string

表示指定字段,不能包含' ^ '。

value

number|string|boolean

表示指定的值。

返回值:

类型

说明

Query

返回Query对象。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. query.equalTo("field", "value");
  4. console.info(`query is ${query.getSqlLike()}`);
  5. query = null;
  6. } catch (e) {
  7. console.error(`duplicated calls should be ok.code is ${e.code},message is ${e.message}`);
  8. }

notEqualTo

notEqualTo(field: string, value: number|string|boolean): Query

构造一个Query对象以查询具有指定字段且值不等于指定值的条目。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

fieId

string

表示指定字段,不能包含' ^ '。

value

number|string|boolean

表示指定的值。

返回值:

类型

说明

Query

返回Query对象。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. query.notEqualTo("field", "value");
  4. console.info(`query is ${query.getSqlLike()}`);
  5. query = null;
  6. } catch (e) {
  7. console.error(`duplicated calls should be ok.code is ${e.code},message is ${e.message}`);
  8. }

greaterThan

greaterThan(field: string, value: number|string|boolean): Query

构造一个Query对象以查询具有大于指定值的指定字段的条目。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

fieId

string

表示指定字段,不能包含' ^ '。

value

number|string|boolean

表示指定的值。

返回值:

类型

说明

Query

返回Query对象。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. query.greaterThan("field", "value");
  4. console.info(`query is ${query.getSqlLike()}`);
  5. query = null;
  6. } catch (e) {
  7. console.error(`duplicated calls should be ok.code is ${e.code},message is ${e.message}`);
  8. }

lessThan

lessThan(field: string, value: number|string): Query

构造一个Query对象以查询具有小于指定值的指定字段的条目。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

fieId

string

表示指定字段,不能包含' ^ '。

value

number|string

表示指定的值。

返回值:

类型

说明

Query

返回Query对象。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. query.lessThan("field", "value");
  4. console.info(`query is ${query.getSqlLike()}`);
  5. query = null;
  6. } catch (e) {
  7. console.error(`duplicated calls should be ok.code is ${e.code},message is ${e.message}`);
  8. }

greaterThanOrEqualTo

greaterThanOrEqualTo(field: string, value: number|string): Query

构造一个Query对象以查询具有指定字段且值大于或等于指定值的条目。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

fieId

string

表示指定字段,不能包含' ^ '。

value

number|string

表示指定的值。

返回值:

类型

说明

Query

返回Query对象。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. query.greaterThanOrEqualTo("field", "value");
  4. console.info(`query is ${query.getSqlLike()}`);
  5. query = null;
  6. } catch (e) {
  7. console.error(`duplicated calls should be ok.code is ${e.code},message is ${e.message}`);
  8. }

lessThanOrEqualTo

lessThanOrEqualTo(field: string, value: number|string): Query

构造一个Query对象以查询具有指定字段且值小于或等于指定值的条目。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

fieId

string

表示指定字段,不能包含' ^ '。

value

number|string

表示指定的值。

返回值:

类型

说明

Query

返回Query对象。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. query.lessThanOrEqualTo("field", "value");
  4. console.info(`query is ${query.getSqlLike()}`);
  5. query = null;
  6. } catch (e) {
  7. console.error(`duplicated calls should be ok.code is ${e.code},message is ${e.message}`);
  8. }

isNull

isNull(field: string): Query

构造一个Query对象以查询具有值为null的指定字段的条目。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

fieId

string

表示指定字段,不能包含' ^ '。

返回值:

类型

说明

Query

返回Query对象。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. query.isNull("field");
  4. console.info(`query is ${query.getSqlLike()}`);
  5. query = null;
  6. } catch (e) {
  7. console.error(`duplicated calls should be ok.code is ${e.code},message is ${e.message}`);
  8. }

inNumber

inNumber(field: string, valueList: number[]): Query

构造一个Query对象以查询具有指定字段的条目,其值在指定的值列表中。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

fieId

string

表示指定字段,不能包含' ^ '。

valueList

number[]

表示指定的值列表。

返回值:

类型

说明

Query

返回Query对象。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. query.inNumber("field", [0, 1]);
  4. console.info(`query is ${query.getSqlLike()}`);
  5. query = null;
  6. } catch (e) {
  7. console.error(`duplicated calls should be ok.code is ${e.code},message is ${e.message}`);
  8. }

inString

inString(field: string, valueList: string[]): Query

构造一个Query对象以查询具有指定字段的条目,其值在指定的字符串值列表中。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

fieId

string

表示指定字段,不能包含' ^ '。

valueList

string[]

表示指定的字符串值列表。

返回值:

类型

说明

Query

返回Query对象。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. query.inString("field", ['test1', 'test2']);
  4. console.info(`query is ${query.getSqlLike()}`);
  5. query = null;
  6. } catch (e) {
  7. console.error(`duplicated calls should be ok.code is ${e.code},message is ${e.message}`);
  8. }

notInNumber

notInNumber(field: string, valueList: number[]): Query

构造一个Query对象以查询具有指定字段的条目,该字段的值不在指定的值列表中。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

fieId

string

表示指定字段,不能包含' ^ '。

valueList

number[]

表示指定的值列表。

返回值:

类型

说明

Query

返回Query对象。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. query.notInNumber("field", [0, 1]);
  4. console.info(`query is ${query.getSqlLike()}`);
  5. query = null;
  6. } catch (e) {
  7. console.error(`duplicated calls should be ok.code is ${e.code},message is ${e.message}`);
  8. }

notInString

notInString(field: string, valueList: string[]): Query

构造一个Query对象以查询具有指定字段且值不在指定字符串值列表中的条目。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

fieId

string

表示指定字段,不能包含' ^ '。

valueList

string[]

表示指定的字符串值列表。

返回值:

类型

说明

Query

返回Query对象。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. query.notInString("field", ['test1', 'test2']);
  4. console.info(`query is ${query.getSqlLike()}`);
  5. query = null;
  6. } catch (e) {
  7. console.error(`duplicated calls should be ok.code is ${e.code},message is ${e.message}`);
  8. }

like

like(field: string, value: string): Query

构造一个Query对象以查询具有与指定字符串值相似的指定字段的条目。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

fieId

string

表示指定字段,不能包含' ^ '。

value

string

表示指定的字符串值。

返回值:

类型

说明

Query

返回Query对象。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. query.like("field", "value");
  4. console.info(`query is ${query.getSqlLike()}`);
  5. query = null;
  6. } catch (e) {
  7. console.error(`duplicated calls should be ok.code is ${e.code},message is ${e.message}`);
  8. }

unlike

unlike(field: string, value: string): Query

构造一个Query对象以查询具有与指定字符串值不相似的指定字段的条目。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

fieId

string

表示指定字段,不能包含' ^ '。

value

string

表示指定的字符串值。

返回值:

类型

说明

Query

返回Query对象。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. query.unlike("field", "value");
  4. console.info(`query is ${query.getSqlLike()}`);
  5. query = null;
  6. } catch (e) {
  7. console.error(`duplicated calls should be ok.code is ${e.code},message is ${e.message}`);
  8. }

and

and(): Query

构造一个带有与条件的查询对象。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

返回值:

类型

说明

Query

返回查询对象。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. query.notEqualTo("field", "value1");
  4. query.and();
  5. query.notEqualTo("field", "value2");
  6. console.info("query is " + query.getSqlLike());
  7. query = null;
  8. } catch (e) {
  9. console.error("duplicated calls should be ok :" + e);
  10. }

or

or(): Query

构造一个带有或条件的Query对象。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

返回值:

类型

说明

Query

返回查询对象。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. query.notEqualTo("field", "value1");
  4. query.or();
  5. query.notEqualTo("field", "value2");
  6. console.info("query is " + query.getSqlLike());
  7. query = null;
  8. } catch (e) {
  9. console.error("duplicated calls should be ok :" + e);
  10. }

orderByAsc

orderByAsc(field: string): Query

构造一个Query对象,将查询结果按升序排序。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

fieId

string

表示指定字段,不能包含' ^ '。

返回值:

类型

说明

Query

返回Query对象。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. query.notEqualTo("field", "value");
  4. query.orderByAsc("field");
  5. console.info(`query is ${query.getSqlLike()}`);
  6. query = null;
  7. } catch (e) {
  8. console.error(`duplicated calls should be ok.code is ${e.code},message is ${e.message}`);
  9. }

orderByDesc

orderByDesc(field: string): Query

构造一个Query对象,将查询结果按降序排序。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

fieId

string

表示指定字段,不能包含' ^ '。

返回值:

类型

说明

Query

返回Query对象。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. query.notEqualTo("field", "value");
  4. query.orderByDesc("field");
  5. console.info(`query is ${query.getSqlLike()}`);
  6. query = null;
  7. } catch (e) {
  8. console.error(`duplicated calls should be ok.code is ${e.code},message is ${e.message}`);
  9. }

limit

limit(total: number, offset: number): Query

构造一个Query对象来指定结果的数量和开始位置。该接口必须要在Query对象查询和升降序等操作之后调用,调用limit接口后,不可再对Query对象进行查询和升降序等操作。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

total

number

表示指定的结果数。

offset

number

表示起始位置。

返回值:

类型

说明

Query

返回Query对象。

示例:

  1. let total = 10;
  2. let offset = 1;
  3. try {
  4. let query = new distributedKVStore.Query();
  5. query.notEqualTo("field", "value");
  6. query.limit(total, offset);
  7. console.info(`query is ${query.getSqlLike()}`);
  8. query = null;
  9. } catch (e) {
  10. console.error(`duplicated calls should be ok.code is ${e.code},message is ${e.message}`);
  11. }

isNotNull

isNotNull(field: string): Query

构造一个Query对象以查询具有值不为null的指定字段的条目。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

fieId

string

表示指定字段,不能包含' ^ '。

返回值:

类型

说明

Query

返回Query对象。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. query.isNotNull("field");
  4. console.info(`query is ${query.getSqlLike()}`);
  5. query = null;
  6. } catch (e) {
  7. console.error(`duplicated calls should be ok.code is ${e.code},message is ${e.message}`);
  8. }

beginGroup

beginGroup(): Query

创建一个带有左括号的查询条件组。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

返回值:

类型

说明

Query

返回Query对象。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. query.beginGroup();
  4. query.isNotNull("field");
  5. query.endGroup();
  6. console.info("query is " + query.getSqlLike());
  7. query = null;
  8. } catch (e) {
  9. console.error("duplicated calls should be ok :" + e);
  10. }

endGroup

endGroup(): Query

创建一个带有右括号的查询条件组。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

返回值:

类型

说明

Query

返回Query对象。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. query.beginGroup();
  4. query.isNotNull("field");
  5. query.endGroup();
  6. console.info("query is " + query.getSqlLike());
  7. query = null;
  8. } catch (e) {
  9. console.error("duplicated calls should be ok :" + e);
  10. }

prefixKey

prefixKey(prefix: string): Query

创建具有指定键前缀的查询条件。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

prefix

string

表示指定的键前缀。

返回值:

类型

说明

Query

返回Query对象。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. query.prefixKey("$.name");
  4. query.prefixKey("0");
  5. console.info(`query is ${query.getSqlLike()}`);
  6. query = null;
  7. } catch (e) {
  8. console.error(`duplicated calls should be ok.code is ${e.code},message is ${e.message}`);
  9. }

setSuggestIndex

setSuggestIndex(index: string): Query

设置一个指定的索引,将优先用于查询。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

index

string

指示要设置的索引。

返回值:

类型

说明

Query

返回Query对象。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. query.setSuggestIndex("$.name");
  4. query.setSuggestIndex("0");
  5. console.info(`query is ${query.getSqlLike()}`);
  6. query = null;
  7. } catch (e) {
  8. console.error(`duplicated calls should be ok.code is ${e.code},message is ${e.message}`);
  9. }

deviceId

deviceId(deviceId:string):Query

添加设备ID作为key的前缀。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

deviceId

string

指示查询的设备ID。

返回值:

类型

说明

Query

返回Query对象。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. query.deviceId("deviceId");
  4. console.info(`query is ${query.getSqlLike()}`);
  5. } catch (e) {
  6. console.error(`duplicated calls should be ok.code is ${e.code},message is ${e.message}`);
  7. }

getSqlLike

getSqlLike():string

获取Query对象的查询语句。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

返回值:

类型

说明

string

返回一个字段列中包含对应子串的结果。

示例:

  1. try {
  2. let query = new distributedKVStore.Query();
  3. let sql1 = query.getSqlLike();
  4. console.info(`GetSqlLike sql= ${sql1}`);
  5. } catch (e) {
  6. console.error("duplicated calls should be ok : " + e);
  7. }

SingleKVStore

SingleKVStore数据库实例,提供增加数据、删除数据和订阅数据变更、订阅数据同步完成的方法。

在调用SingleKVStore的方法前,需要先通过getKVStore构建一个SingleKVStore实例。

put

put(key: string, value: Uint8Array | string | number | boolean, callback: AsyncCallback<void>): void

添加指定类型键值对到数据库,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

key

string

要添加数据的key,不能为空且长度不大于MAX_KEY_LENGTH

value

Uint8Array | string | number | boolean

要添加数据的value,支持Uint8Array、number 、 string 、boolean,Uint8Array、string 的长度不大于MAX_VALUE_LENGTH

callback

AsyncCallback<void>

回调函数。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. const KEY_TEST_STRING_ELEMENT = 'key_test_string';
  2. const VALUE_TEST_STRING_ELEMENT = 'value-test-string';
  3. try {
  4. kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT, function (err) {
  5. if (err != undefined) {
  6. console.error(`Failed to put.code is ${err.code},message is ${err.message}`);
  7. return;
  8. }
  9. console.info("Succeeded in putting");
  10. });
  11. } catch (e) {
  12. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  13. }

put

put(key: string, value: Uint8Array | string | number | boolean): Promise<void>

添加指定类型键值对到数据库,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

key

string

要添加数据的key,不能为空且长度不大于MAX_KEY_LENGTH

value

Uint8Array | string | number | boolean

要添加数据的value,支持Uint8Array、number 、 string 、boolean,Uint8Array、string 的长度不大于MAX_VALUE_LENGTH

返回值:

类型

说明

Promise<void>

无返回结果的Promise对象。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. const KEY_TEST_STRING_ELEMENT = 'key_test_string';
  2. const VALUE_TEST_STRING_ELEMENT = 'value-test-string';
  3. try {
  4. kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT).then(() => {
  5. console.info(`Succeeded in putting data.`);
  6. }).catch((err) => {
  7. console.error(`Failed to put.code is ${err.code},message is ${err.message}`);
  8. });
  9. } catch (e) {
  10. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  11. }

putBatch

putBatch(entries: Entry[], callback: AsyncCallback<void>): void

批量插入键值对到SingleKVStore数据库中,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

entries

Entry[]

表示要批量插入的键值对。一个entries对象中允许的最大条目个数为128个。

callback

AsyncCallback<void>

回调函数。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let entries = [];
  3. for (var i = 0; i < 10; i++) {
  4. var key = 'batch_test_string_key';
  5. var entry = {
  6. key: key + i,
  7. value: {
  8. type: distributedKVStore.ValueType.STRING,
  9. value: 'batch_test_string_value'
  10. }
  11. }
  12. entries.push(entry);
  13. }
  14. console.info(`entries: ${entries}`);
  15. kvStore.putBatch(entries, async function (err) {
  16. if (err != undefined) {
  17. console.error(`Failed to put Batch.code is ${err.code},message is ${err.message}`);
  18. return;
  19. }
  20. console.info('Succeeded in putting Batch');
  21. kvStore.getEntries('batch_test_string_key', function (err, entries) {
  22. if (err != undefined) {
  23. console.error(`Failed to get Entries.code is ${err.code},message is ${err.message}`);
  24. }
  25. console.info('Succeeded in getting Entries');
  26. console.info(`entries.length: ${entries.length}`);
  27. console.info(`entries[0]: ${entries[0]}`);
  28. });
  29. });
  30. } catch (e) {
  31. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message} `);
  32. }

putBatch

putBatch(entries: Entry[]): Promise<void>

批量插入键值对到SingleKVStore数据库中,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

entries

Entry[]

表示要批量插入的键值对。一个entries对象中允许的最大条目个数为128个。

返回值:

类型

说明

Promise<void>

无返回结果的Promise对象。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let entries = [];
  3. for (var i = 0; i < 10; i++) {
  4. var key = 'batch_test_string_key';
  5. var entry = {
  6. key: key + i,
  7. value: {
  8. type: distributedKVStore.ValueType.STRING,
  9. value: 'batch_test_string_value'
  10. }
  11. }
  12. entries.push(entry);
  13. }
  14. console.info(`entries: ${entries}`);
  15. kvStore.putBatch(entries).then(async () => {
  16. console.info('Succeeded in putting Batch');
  17. kvStore.getEntries('batch_test_string_key').then((entries) => {
  18. console.info('Succeeded in getting Entries');
  19. console.info(`PutBatch ${entries}`);
  20. }).catch((err) => {
  21. console.error(`Failed to get Entries.code is ${err.code},message is ${err.message}`);
  22. });
  23. }).catch((err) => {
  24. console.error(`Failed to put Batch.code is ${err.code},message is ${err.message}`);
  25. });
  26. } catch (e) {
  27. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message} `);
  28. }

delete

delete(key: string, callback: AsyncCallback<void>): void

从数据库中删除指定键值的数据,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

key

string

要删除数据的key,不能为空且长度不大于MAX_KEY_LENGTH

callback

AsyncCallback<void>

回调函数。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. const KEY_TEST_STRING_ELEMENT = 'key_test_string';
  2. const VALUE_TEST_STRING_ELEMENT = 'value-test-string';
  3. try {
  4. kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT, function (err) {
  5. if (err != undefined) {
  6. console.error(`Failed to put.code is ${err.code},message is ${err.message}`);
  7. return;
  8. }
  9. console.info('Succeeded in putting');
  10. kvStore.delete(KEY_TEST_STRING_ELEMENT, function (err) {
  11. if (err != undefined) {
  12. console.error(`Failed to delete.code is ${err.code},message is ${err.message}`);
  13. return;
  14. }
  15. console.info('Succeeded in deleting');
  16. });
  17. });
  18. } catch (e) {
  19. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  20. }

delete

delete(key: string): Promise<void>

从数据库中删除指定键值的数据,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

key

string

要删除数据的key,不能为空且长度不大于MAX_KEY_LENGTH

返回值:

类型

说明

Promise<void>

无返回结果的Promise对象。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. const KEY_TEST_STRING_ELEMENT = 'key_test_string';
  2. const VALUE_TEST_STRING_ELEMENT = 'value-test-string';
  3. try {
  4. kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT).then(() => {
  5. console.info(`Succeeded in putting data`);
  6. kvStore.delete(KEY_TEST_STRING_ELEMENT).then(() => {
  7. console.info('Succeeded in deleting');
  8. }).catch((err) => {
  9. console.error(`Failed to delete.code is ${err.code},message is ${err.message}`);
  10. });
  11. }).catch((err) => {
  12. console.error(`Failed to put.code is ${err.code},message is ${err.message}`);
  13. });
  14. } catch (e) {
  15. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  16. }

deleteBatch

deleteBatch(keys: string[], callback: AsyncCallback<void>): void

批量删除SingleKVStore数据库中的键值对,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

keys

string[]

表示要批量删除的键值对。

callback

AsyncCallback<void>

回调函数。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let entries = [];
  3. let keys = [];
  4. for (var i = 0; i < 5; i++) {
  5. var key = 'batch_test_string_key';
  6. var entry = {
  7. key: key + i,
  8. value: {
  9. type: distributedKVStore.ValueType.STRING,
  10. value: 'batch_test_string_value'
  11. }
  12. }
  13. entries.push(entry);
  14. keys.push(key + i);
  15. }
  16. console.info(`entries: ${entries}`);
  17. kvStore.putBatch(entries, async function (err) {
  18. if (err != undefined) {
  19. console.error(`Failed to put Batch.code is ${err.code},message is ${err.message}`);
  20. return;
  21. }
  22. console.info('Succeeded in putting Batch');
  23. kvStore.deleteBatch(keys, async function (err) {
  24. if (err != undefined) {
  25. console.error(`Failed to delete Batch.code is ${err.code},message is ${err.message}`);
  26. return;
  27. }
  28. console.info('Succeeded in deleting Batch');
  29. });
  30. });
  31. } catch (e) {
  32. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  33. }

deleteBatch

deleteBatch(keys: string[]): Promise<void>

批量删除SingleKVStore数据库中的键值对,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

keys

string[]

表示要批量删除的键值对。

返回值:

类型

说明

Promise<void>

无返回结果的Promise对象。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let entries = [];
  3. let keys = [];
  4. for (var i = 0; i < 5; i++) {
  5. var key = 'batch_test_string_key';
  6. var entry = {
  7. key: key + i,
  8. value: {
  9. type: distributedKVStore.ValueType.STRING,
  10. value: 'batch_test_string_value'
  11. }
  12. }
  13. entries.push(entry);
  14. keys.push(key + i);
  15. }
  16. console.info(`entries: ${entries}`);
  17. kvStore.putBatch(entries).then(async () => {
  18. console.info('Succeeded in putting Batch');
  19. kvStore.deleteBatch(keys).then(() => {
  20. console.info('Succeeded in deleting Batch');
  21. }).catch((err) => {
  22. console.error(`Failed to delete Batch.code is ${err.code},message is ${err.message}`);
  23. });
  24. }).catch((err) => {
  25. console.error(`Failed to put Batch.code is ${err.code},message is ${err.message}`);
  26. });
  27. } catch (e) {
  28. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  29. }

removeDeviceData

removeDeviceData(deviceId: string, callback: AsyncCallback<void>): void

删除指定设备的数据,使用callback异步回调。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.DistributedKVStore

参数:

参数名

类型

必填

说明

deviceId

string

表示要删除设备的名称。

callback

AsyncCallback<void>

回调函数。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100005

Database or result set already closed.

示例:

  1. const KEY_TEST_STRING_ELEMENT = 'key_test_string_2';
  2. const VALUE_TEST_STRING_ELEMENT = 'value-string-002';
  3. try {
  4. kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT, async function (err) {
  5. console.info('Succeeded in putting data');
  6. const deviceId = 'no_exist_device_id';
  7. kvStore.removeDeviceData(deviceId, async function (err) {
  8. if (err == undefined) {
  9. console.info('succeeded in removing device data');
  10. } else {
  11. console.error(`Failed to remove device data.code is ${err.code},message is ${err.message} `);
  12. kvStore.get(KEY_TEST_STRING_ELEMENT, async function (err, data) {
  13. console.info('Succeeded in getting data');
  14. });
  15. }
  16. });
  17. });
  18. } catch (e) {
  19. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`)
  20. }

removeDeviceData

removeDeviceData(deviceId: string): Promise<void>

删除指定设备的数据,使用Promise异步回调。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.DistributedKVStore

参数:

参数名

类型

必填

说明

deviceId

string

表示要删除设备的名称。

返回值:

类型

说明

Promise<void>

无返回结果的Promise对象。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100005

Database or result set already closed.

示例:

  1. const KEY_TEST_STRING_ELEMENT = 'key_test_string_2';
  2. const VALUE_TEST_STRING_ELEMENT = 'value-string-001';
  3. try {
  4. kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT).then(() => {
  5. console.info('Succeeded in putting data');
  6. }).catch((err) => {
  7. console.error(`Failed to put data.code is ${err.code},message is ${err.message} `);
  8. });
  9. const deviceId = 'no_exist_device_id';
  10. kvStore.removeDeviceData(deviceId).then(() => {
  11. console.info('succeeded in removing device data');
  12. }).catch((err) => {
  13. console.error(`Failed to remove device data.code is ${err.code},message is ${err.message} `);
  14. });
  15. kvStore.get(KEY_TEST_STRING_ELEMENT).then((data) => {
  16. console.info('Succeeded in getting data');
  17. }).catch((err) => {
  18. console.error(`Failed to get data.code is ${err.code},message is ${err.message} `);
  19. });
  20. } catch (e) {
  21. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`)
  22. }

get

get(key: string, callback: AsyncCallback<boolean | string | number | Uint8Array>): void

获取指定键的值,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

key

string

要查询数据的key,不能为空且长度不大于MAX_KEY_LENGTH

callback

AsyncCallback<boolean | string | number | Uint8Array>

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

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100004

Not found.

15100005

Database or result set already closed.

示例:

  1. const KEY_TEST_STRING_ELEMENT = 'key_test_string';
  2. const VALUE_TEST_STRING_ELEMENT = 'value-test-string';
  3. try {
  4. kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT, function (err) {
  5. if (err != undefined) {
  6. console.error(`Failed to put.code is ${err.code},message is ${err.message}`);
  7. return;
  8. }
  9. console.info("Succeeded in putting");
  10. kvStore.get(KEY_TEST_STRING_ELEMENT, function (err, data) {
  11. if (err != undefined) {
  12. console.error(`Failed to get.code is ${err.code},message is ${err.message}`);
  13. return;
  14. }
  15. console.info(`Succeeded in getting data.data=${data}`);
  16. });
  17. });
  18. } catch (e) {
  19. console.error(`Failed to get.code is ${e.code},message is ${e.message}`);
  20. }

get

get(key: string): Promise<boolean | string | number | Uint8Array>

获取指定键的值,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

key

string

要查询数据的key,不能为空且长度不大于MAX_KEY_LENGTH

返回值:

类型

说明

Promise<Uint8Array | string | boolean | number>

Promise对象。返回获取查询的值。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100004

Not found.

15100005

Database or result set already closed.

示例:

  1. const KEY_TEST_STRING_ELEMENT = 'key_test_string';
  2. const VALUE_TEST_STRING_ELEMENT = 'value-test-string';
  3. try {
  4. kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT).then(() => {
  5. console.info(`Succeeded in putting data`);
  6. kvStore.get(KEY_TEST_STRING_ELEMENT).then((data) => {
  7. console.info(`Succeeded in getting data.data=${data}`);
  8. }).catch((err) => {
  9. console.error(`Failed to get.code is ${err.code},message is ${err.message}`);
  10. });
  11. }).catch((err) => {
  12. console.error(`Failed to put.code is ${err.code},message is ${err.message}`);
  13. });
  14. } catch (e) {
  15. console.error(`Failed to get.code is ${e.code},message is ${e.message}`);
  16. }

getEntries

getEntries(keyPrefix: string, callback: AsyncCallback<Entry[]>): void

获取匹配指定键前缀的所有键值对,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

keyPrefix

string

表示要匹配的键前缀。

callback

AsyncCallback<Entry[]>

回调函数。返回匹配指定前缀的键值对列表。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let entries = [];
  3. for (var i = 0; i < 10; i++) {
  4. var key = 'batch_test_string_key';
  5. var entry = {
  6. key: key + i,
  7. value: {
  8. type: distributedKVStore.ValueType.STRING,
  9. value: 'batch_test_string_value'
  10. }
  11. }
  12. entries.push(entry);
  13. }
  14. console.info(`entries: ${entries}`);
  15. kvStore.putBatch(entries, async function (err) {
  16. if (err != undefined) {
  17. console.error(`Failed to put Batch.code is ${err.code},message is ${err.message}`);
  18. return;
  19. }
  20. console.info('Succeeded in putting Batch');
  21. kvStore.getEntries('batch_test_string_key', function (err, entries) {
  22. if (err != undefined) {
  23. console.error(`Failed to get Entries.code is ${err.code},message is ${err.message}`);
  24. return;
  25. }
  26. console.info('Succeeded in getting Entries');
  27. console.info(`entries.length: ${entries.length}`);
  28. console.info(`entries[0]: ${entries[0]}`);
  29. });
  30. });
  31. } catch (e) {
  32. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message} `);
  33. }

getEntries

getEntries(keyPrefix: string): Promise<Entry[]>

获取匹配指定键前缀的所有键值对,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

keyPrefix

string

表示要匹配的键前缀。

返回值:

类型

说明

Promise<Entry[]>

Promise对象。返回匹配指定前缀的键值对列表。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let entries = [];
  3. for (var i = 0; i < 10; i++) {
  4. var key = 'batch_test_string_key';
  5. var entry = {
  6. key: key + i,
  7. value: {
  8. type: distributedKVStore.ValueType.STRING,
  9. value: 'batch_test_string_value'
  10. }
  11. }
  12. entries.push(entry);
  13. }
  14. console.info(`entries: ${entries}`);
  15. kvStore.putBatch(entries).then(async () => {
  16. console.info('Succeeded in putting Batch');
  17. kvStore.getEntries('batch_test_string_key').then((entries) => {
  18. console.info('Succeeded in getting Entries');
  19. console.info(`PutBatch ${entries}`);
  20. }).catch((err) => {
  21. console.error(`Failed to get Entries.code is ${err.code},message is ${err.message}`);
  22. });
  23. }).catch((err) => {
  24. console.error(`Failed to put Batch.code is ${err.code},message is ${err.message}`);
  25. });
  26. } catch (e) {
  27. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message} `);
  28. }

getEntries

getEntries(query: Query, callback: AsyncCallback<Entry[]>): void

获取与指定Query对象匹配的键值对列表,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

query

Query

表示要匹配的键前缀。

callback

AsyncCallback<Entry[]>

回调函数。返回与指定Query对象匹配的键值对列表。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. var arr = new Uint8Array([21, 31]);
  3. let entries = [];
  4. for (var i = 0; i < 10; i++) {
  5. var key = 'batch_test_bool_key';
  6. var entry = {
  7. key: key + i,
  8. value: {
  9. type: distributedKVStore.ValueType.BYTE_ARRAY,
  10. value: arr
  11. }
  12. }
  13. entries.push(entry);
  14. }
  15. console.info(`entries: {entries}`);
  16. kvStore.putBatch(entries, async function (err) {
  17. console.info('Succeeded in putting Batch');
  18. const query = new distributedKVStore.Query();
  19. query.prefixKey("batch_test");
  20. kvStore.getEntries(query, function (err, entries) {
  21. if (err != undefined) {
  22. console.error(`Failed to get Entries.code is ${err.code},message is ${err.message}`);
  23. return;
  24. }
  25. console.info('Succeeded in getting Entries');
  26. console.info(`entries.length: ${entries.length}`);
  27. console.info(`entries[0]: ${entries[0]}`);
  28. });
  29. });
  30. } catch (e) {
  31. console.error(`Failed to get Entries.code is ${e.code},message is ${e.message}`);
  32. }

getEntries

getEntries(query: Query): Promise<Entry[]>

获取与指定Query对象匹配的键值对列表,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

query

Query

表示查询对象。

返回值:

类型

说明

Promise<Entry[]>

Promise对象。返回与指定Query对象匹配的键值对列表。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. var arr = new Uint8Array([21, 31]);
  3. let entries = [];
  4. for (var i = 0; i < 10; i++) {
  5. var key = 'batch_test_bool_key';
  6. var entry = {
  7. key: key + i,
  8. value: {
  9. type: distributedKVStore.ValueType.BYTE_ARRAY,
  10. value: arr
  11. }
  12. }
  13. entries.push(entry);
  14. }
  15. console.info(`entries: {entries}`);
  16. kvStore.putBatch(entries).then(async () => {
  17. console.info('Succeeded in putting Batch');
  18. const query = new distributedKVStore.Query();
  19. query.prefixKey("batch_test");
  20. kvStore.getEntries(query).then((entries) => {
  21. console.info('Succeeded in getting Entries');
  22. }).catch((err) => {
  23. console.error(`Failed to get Entries.code is ${err.code},message is ${err.message}`);
  24. });
  25. }).catch((err) => {
  26. console.error(`Failed to get Entries.code is ${err.code},message is ${err.message}`)
  27. });
  28. console.info('Succeeded in getting Entries');
  29. } catch (e) {
  30. console.error(`Failed to get Entries.code is ${e.code},message is ${e.message}`);
  31. }

getResultSet

getResultSet(keyPrefix: string, callback: AsyncCallback<KVStoreResultSet>): void

从SingleKVStore数据库中获取具有指定前缀的结果集,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

keyPrefix

string

表示要匹配的键前缀。

callback

AsyncCallback<KVStoreResultSet>

回调函数。返回具有指定前缀的结果集。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let resultSet;
  3. let entries = [];
  4. for (var i = 0; i < 10; i++) {
  5. var key = 'batch_test_string_key';
  6. var entry = {
  7. key: key + i,
  8. value: {
  9. type: distributedKVStore.ValueType.STRING,
  10. value: 'batch_test_string_value'
  11. }
  12. }
  13. entries.push(entry);
  14. }
  15. kvStore.putBatch(entries, async function (err) {
  16. if (err != undefined) {
  17. console.error(`Failed to put batch.code is ${err.code},message is ${err.message}`);
  18. return;
  19. }
  20. console.info('Succeeded in putting batch');
  21. kvStore.getResultSet('batch_test_string_key', async function (err, result) {
  22. if (err != undefined) {
  23. console.error(`Failed to get resultset.code is ${err.code},message is ${err.message}`);
  24. return;
  25. }
  26. console.info('Succeeded in getting result set');
  27. resultSet = result;
  28. kvStore.closeResultSet(resultSet, function (err) {
  29. if (err != undefined) {
  30. console.error(`Failed to close resultset.code is ${err.code},message is ${err.message}`);
  31. return;
  32. }
  33. console.info('Succeeded in closing result set');
  34. })
  35. });
  36. });
  37. } catch (e) {
  38. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  39. }

getResultSet

getResultSet(keyPrefix: string): Promise<KVStoreResultSet>

从SingleKVStore数据库中获取具有指定前缀的结果集,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

keyPrefix

string

表示要匹配的键前缀。

返回值:

类型

说明

Promise<KVStoreResultSet>

Promise对象。返回具有指定前缀的结果集。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let resultSet;
  3. let entries = [];
  4. for (var i = 0; i < 10; i++) {
  5. var key = 'batch_test_string_key';
  6. var entry = {
  7. key: key + i,
  8. value: {
  9. type: distributedKVStore.ValueType.STRING,
  10. value: 'batch_test_string_value'
  11. }
  12. }
  13. entries.push(entry);
  14. }
  15. kvStore.putBatch(entries).then(async () => {
  16. console.info('Succeeded in putting batch');
  17. }).catch((err) => {
  18. console.error(`Failed to put batch.code is ${err.code},message is ${err.message}`);
  19. });
  20. kvStore.getResultSet('batch_test_string_key').then((result) => {
  21. console.info('Succeeded in getting result set');
  22. resultSet = result;
  23. }).catch((err) => {
  24. console.error(`Failed to get resultset.code is ${err.code},message is ${err.message}`);
  25. });
  26. kvStore.closeResultSet(resultSet).then(() => {
  27. console.info('Succeeded in closing result set');
  28. }).catch((err) => {
  29. console.error(`Failed to close resultset.code is ${err.code},message is ${err.message}`);
  30. });
  31. } catch (e) {
  32. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.code}`);
  33. }

getResultSet

getResultSet(query: Query, callback: AsyncCallback<KVStoreResultSet>): void

获取与指定Query对象匹配的KVStoreResultSet对象,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

query

Query

表示查询对象。

callback

AsyncCallback<KVStoreResultSet>

回调函数,获取与指定Query对象匹配的KVStoreResultSet对象。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let resultSet;
  3. let entries = [];
  4. for (var i = 0; i < 10; i++) {
  5. var key = 'batch_test_string_key';
  6. var entry = {
  7. key: key + i,
  8. value: {
  9. type: distributedKVStore.ValueType.STRING,
  10. value: 'batch_test_string_value'
  11. }
  12. }
  13. entries.push(entry);
  14. }
  15. kvStore.putBatch(entries, async function (err) {
  16. if (err != undefined) {
  17. console.error(`Failed to put batch.code is ${err.code},message is ${err.message}`);
  18. return;
  19. }
  20. console.info('Succeeded in putting batch');
  21. const query = new distributedKVStore.Query();
  22. query.prefixKey("batch_test");
  23. kvStore.getResultSet(query, async function (err, result) {
  24. if (err != undefined) {
  25. console.error(`Failed to get resultset.code is ${err.code},message is ${err.message}`);
  26. return;
  27. }
  28. console.info('Succeeded in getting result set');
  29. });
  30. });
  31. } catch (e) {
  32. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  33. }

getResultSet

getResultSet(query: Query): Promise<KVStoreResultSet>

获取与指定Query对象匹配的KVStoreResultSet对象,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

query

Query

表示查询对象。

返回值:

类型

说明

Promise<KVStoreResultSet>

Promise对象。获取与指定Query对象匹配的KVStoreResultSet对象。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let resultSet;
  3. let entries = [];
  4. for (var i = 0; i < 10; i++) {
  5. var key = 'batch_test_string_key';
  6. var entry = {
  7. key: key + i,
  8. value: {
  9. type: distributedKVStore.ValueType.STRING,
  10. value: 'batch_test_string_value'
  11. }
  12. }
  13. entries.push(entry);
  14. }
  15. kvStore.putBatch(entries).then(async () => {
  16. console.info('Succeeded in putting batch');
  17. }).catch((err) => {
  18. console.error(`Failed to put batch.code is ${err.code},message is ${err.message}`);
  19. });
  20. const query = new distributedKVStore.Query();
  21. query.prefixKey("batch_test");
  22. kvStore.getResultSet(query).then((result) => {
  23. console.info('Succeeded in getting result set');
  24. resultSet = result;
  25. }).catch((err) => {
  26. console.error(`Failed to get resultset.code is ${err.code},message is ${err.message}`);
  27. });
  28. } catch (e) {
  29. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.code}`);
  30. }

closeResultSet

closeResultSet(resultSet: KVStoreResultSet, callback: AsyncCallback<void>): void

关闭由SingleKvStore.getResultSet返回的KVStoreResultSet对象,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

resultSet

KVStoreResultSet

表示要关闭的KVStoreResultSet对象。

callback

AsyncCallback<void>

回调函数。

示例:

  1. try {
  2. let resultSet = null;
  3. kvStore.closeResultSet(resultSet, function (err) {
  4. if (err == undefined) {
  5. console.info('Succeeded in closing result set');
  6. } else {
  7. console.error(`Failed to close resultset.code is ${err.code},message is ${err.message}`);
  8. }
  9. });
  10. } catch (e) {
  11. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.code}`);
  12. }

closeResultSet

closeResultSet(resultSet: KVStoreResultSet): Promise<void>

关闭由SingleKvStore.getResultSet返回的KVStoreResultSet对象,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

resultSet

KVStoreResultSet

表示要关闭的KVStoreResultSet对象。

返回值:

类型

说明

Promise<void>

无返回结果的Promise对象。

示例:

  1. try {
  2. let resultSet = null;
  3. kvStore.closeResultSet(resultSet).then(() => {
  4. console.info('Succeeded in closing result set');
  5. }).catch((err) => {
  6. console.error(`Failed to close resultset.code is ${err.code},message is ${err.message}`);
  7. });
  8. } catch (e) {
  9. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.code}`);
  10. }

getResultSize

getResultSize(query: Query, callback: AsyncCallback<number>): void

获取与指定Query对象匹配的结果数,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

query

Query

表示查询对象。

callback

AsyncCallback<number>

回调函数。返回与指定Query对象匹配的结果数。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let entries = [];
  3. for (var i = 0; i < 10; i++) {
  4. var key = 'batch_test_string_key';
  5. var entry = {
  6. key: key + i,
  7. value: {
  8. type: distributedKVStore.ValueType.STRING,
  9. value: 'batch_test_string_value'
  10. }
  11. }
  12. entries.push(entry);
  13. }
  14. kvStore.putBatch(entries, async function (err) {
  15. console.info('Succeeded in putting batch');
  16. const query = new distributedKVStore.Query();
  17. query.prefixKey("batch_test");
  18. kvStore.getResultSize(query, async function (err, resultSize) {
  19. if (err != undefined) {
  20. console.error(`Failed to get result size.code is ${err.code},message is ${err.message}`);
  21. return;
  22. }
  23. console.info('Succeeded in getting result set size');
  24. });
  25. });
  26. } catch (e) {
  27. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.code}`);
  28. }

getResultSize

getResultSize(query: Query): Promise<number>

获取与指定Query对象匹配的结果数,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

query

Query

表示查询对象。

返回值:

类型

说明

Promise<number>

Promise对象。获取与指定QuerV9对象匹配的结果数。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let entries = [];
  3. for (var i = 0; i < 10; i++) {
  4. var key = 'batch_test_string_key';
  5. var entry = {
  6. key: key + i,
  7. value: {
  8. type: distributedKVStore.ValueType.STRING,
  9. value: 'batch_test_string_value'
  10. }
  11. }
  12. entries.push(entry);
  13. }
  14. kvStore.putBatch(entries).then(async () => {
  15. console.info('Succeeded in putting batch');
  16. }).catch((err) => {
  17. console.error(`Failed to put batch.code is ${err.code},message is ${err.message}`);
  18. });
  19. const query = new distributedKVStore.Query();
  20. query.prefixKey("batch_test");
  21. kvStore.getResultSize(query).then((resultSize) => {
  22. console.info('Succeeded in getting result set size');
  23. }).catch((err) => {
  24. console.error(`Failed to get result size.code is ${err.code},message is ${err.message}`);
  25. });
  26. } catch (e) {
  27. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.code}`);
  28. }

backup

backup(file:string, callback: AsyncCallback<void>):void

以指定名称备份数据库,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

file

string

备份数据库的指定名称,不能为空且长度不大于MAX_KEY_LENGTH

callback

AsyncCallback<void>

回调函数。当以指定名称备份数据库成功,err为undefined,否则为错误对象。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100005

Database or result set already closed.

示例:

  1. let file = "BK001";
  2. try {
  3. kvStore.backup(file, (err) => {
  4. if (err) {
  5. console.error(`Failed to backup.code is ${err.code},message is ${err.message} `);
  6. } else {
  7. console.info(`Succeeded in backupping data.`);
  8. }
  9. });
  10. } catch (e) {
  11. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  12. }

backup

backup(file:string): Promise<void>

以指定名称备份数据库,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

file

string

备份数据库的指定名称,不能为空且长度不大于MAX_KEY_LENGTH

返回值:

类型

说明

Promise<void>

无返回结果的Promise对象。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100005

Database or result set already closed.

示例:

  1. let file = "BK001";
  2. try {
  3. kvStore.backup(file).then(() => {
  4. console.info(`Succeeded in backupping data.`);
  5. }).catch((err) => {
  6. console.error(`Failed to backup.code is ${err.code},message is ${err.message}`);
  7. });
  8. } catch (e) {
  9. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  10. }

restore

restore(file:string, callback: AsyncCallback<void>):void

从指定的数据库文件恢复数据库,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

file

string

指定的数据库文件名称,不能为空且长度不大于MAX_KEY_LENGTH

callback

AsyncCallback<void>

回调函数。当从指定的数据库文件恢复数据库成功,err为undefined,否则为错误对象。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100005

Database or result set already closed.

示例:

  1. let file = "BK001";
  2. try {
  3. kvStore.restore(file, (err) => {
  4. if (err) {
  5. console.error(`Failed to restore.code is ${err.code},message is ${err.message}`);
  6. } else {
  7. console.info(`Succeeded in restoring data.`);
  8. }
  9. });
  10. } catch (e) {
  11. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  12. }

restore

restore(file:string): Promise<void>

从指定的数据库文件恢复数据库,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

file

string

指定的数据库文件名称,不能为空且长度不大于MAX_KEY_LENGTH

返回值:

类型

说明

Promise<void>

无返回结果的Promise对象。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100005

Database or result set already closed.

示例:

  1. let file = "BK001";
  2. try {
  3. kvStore.restore(file).then(() => {
  4. console.info(`Succeeded in restoring data.`);
  5. }).catch((err) => {
  6. console.error(`Failed to restore.code is ${err.code},message is ${err.message}`);
  7. });
  8. } catch (e) {
  9. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  10. }

deleteBackup

deleteBackup(files:Array<string>, callback: AsyncCallback<Array<[string, number]>>):void

根据指定名称删除备份文件,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

files

Array<string>

删除备份文件所指定的名称,不能为空且长度不大于MAX_KEY_LENGTH

callback

AsyncCallback<Array<[string, number]>>

回调函数,返回删除备份的文件名及其处理结果。

示例:

  1. let files = ["BK001", "BK002"];
  2. try {
  3. kvStore.deleteBackup(files, (err, data) => {
  4. if (err) {
  5. console.error(`Failed to delete Backup.code is ${err.code},message is ${err.message}`);
  6. } else {
  7. console.info(`Succeed in deleting Backup.data=${data}`);
  8. }
  9. });
  10. } catch (e) {
  11. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  12. }

deleteBackup

deleteBackup(files:Array<string>): Promise<Array<[string, number]>>

根据指定名称删除备份文件,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

files

Array<string>

删除备份文件所指定的名称,不能为空且长度不大于MAX_KEY_LENGTH

返回值:

类型

说明

Promise<Array<[string, number]>>

Promise对象,返回删除备份的文件名及其处理结果。

示例:

  1. let files = ["BK001", "BK002"];
  2. try {
  3. kvStore.deleteBackup(files).then((data) => {
  4. console.info(`Succeed in deleting Backup.data=${data}`);
  5. }).catch((err) => {
  6. console.error(`Failed to delete Backup.code is ${err.code},message is ${err.message}`);
  7. })
  8. } catch (e) {
  9. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  10. }

startTransaction

startTransaction(callback: AsyncCallback<void>): void

启动SingleKVStore数据库中的事务,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

callback

AsyncCallback<void>

回调函数。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100005

Database or result set already closed.

示例:

  1. function putBatchString(len, prefix) {
  2. let entries = [];
  3. for (var i = 0; i < len; i++) {
  4. var entry = {
  5. key: prefix + i,
  6. value: {
  7. type: distributedKVStore.ValueType.STRING,
  8. value: 'batch_test_string_value'
  9. }
  10. }
  11. entries.push(entry);
  12. }
  13. return entries;
  14. }
  15. try {
  16. var count = 0;
  17. kvStore.on('dataChange', 0, function (data) {
  18. console.info(`startTransaction 0 ${data}`);
  19. count++;
  20. });
  21. kvStore.startTransaction(async function (err) {
  22. if (err != undefined) {
  23. console.error(`Failed to start Transaction.code is ${err.code},message is ${err.message}`);
  24. return;
  25. }
  26. console.info('Succeeded in starting Transaction');
  27. let entries = putBatchString(10, 'batch_test_string_key');
  28. console.info(`entries: ${entries}`);
  29. kvStore.putBatch(entries, async function (err) {
  30. if (err != undefined) {
  31. console.error(`Failed to put batch.code is ${err.code},message is ${err.message}`);
  32. return;
  33. }
  34. console.info('Succeeded in putting Batch');
  35. });
  36. });
  37. } catch (e) {
  38. console.error(`Failed to start Transaction.code is ${e.code},message is ${e.message}`);
  39. }

startTransaction

startTransaction(): Promise<void>

启动SingleKVStore数据库中的事务,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

返回值:

类型

说明

Promise<void>

无返回结果的Promise对象。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100005

Database or result set already closed.

示例:

  1. try {
  2. var count = 0;
  3. kvStore.on('dataChange', distributedKVStore.SubscribeType.SUBSCRIBE_TYPE_ALL, function (data) {
  4. console.info(`startTransaction 0 ${data}`);
  5. count++;
  6. });
  7. kvStore.startTransaction().then(async () => {
  8. console.info('Succeeded in starting Transaction');
  9. }).catch((err) => {
  10. console.error(`Failed to start Transaction.code is ${err.code},message is ${err.message}`);
  11. });
  12. } catch (e) {
  13. console.error(`Failed to start Transaction.code is ${e.code},message is ${e.message}`);
  14. }

commit

commit(callback: AsyncCallback<void>): void

提交SingleKVStore数据库中的事务,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

callback

AsyncCallback<void>

回调函数。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100005

Database or result set already closed.

示例:

  1. try {
  2. kvStore.commit(function (err) {
  3. if (err == undefined) {
  4. console.info('Succeeded in committing');
  5. } else {
  6. console.error(`Failed to commit.code is ${err.code},message is ${err.message}`);
  7. }
  8. });
  9. } catch (e) {
  10. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  11. }

commit

commit(): Promise<void>

提交SingleKVStore数据库中的事务,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

返回值:

类型

说明

Promise<void>

无返回结果的Promise对象。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100005

Database or result set already closed.

示例:

  1. try {
  2. kvStore.commit().then(async () => {
  3. console.info('Succeeded in committing');
  4. }).catch((err) => {
  5. console.error(`Failed to commit.code is ${err.code},message is ${err.message}`);
  6. });
  7. } catch (e) {
  8. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  9. }

rollback

rollback(callback: AsyncCallback<void>): void

在SingleKVStore数据库中回滚事务,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

callback

AsyncCallback<void>

回调函数。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100005

Database or result set already closed.

示例:

  1. try {
  2. kvStore.rollback(function (err) {
  3. if (err == undefined) {
  4. console.info('Succeeded in rolling back');
  5. } else {
  6. console.error(`Failed to rollback.code is ${err.code},message is ${err.message}`);
  7. }
  8. });
  9. }catch(e) {
  10. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  11. }

rollback

rollback(): Promise<void>

在SingleKVStore数据库中回滚事务,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

返回值:

类型

说明

Promise<void>

无返回结果的Promise对象。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100005

Database or result set already closed.

示例:

  1. try {
  2. kvStore.rollback().then(async () => {
  3. console.info('Succeeded in rolling back');
  4. }).catch((err) => {
  5. console.error(`Failed to rollback.code is ${err.code},message is ${err.message}`);
  6. });
  7. } catch (e) {
  8. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  9. }

enableSync

enableSync(enabled: boolean, callback: AsyncCallback<void>): void

设定是否开启同步,使用callback异步回调。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

enabled

boolean

设定是否开启同步,true表示开启同步,false表示不启用同步。

callback

AsyncCallback<void>

回调函数。

示例:

  1. try {
  2. kvStore.enableSync(true, function (err) {
  3. if (err == undefined) {
  4. console.info('Succeeded in enabling sync');
  5. } else {
  6. console.error(`Failed to enable sync.code is ${err.code},message is ${err.message}`);
  7. }
  8. });
  9. } catch (e) {
  10. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  11. }

enableSync

enableSync(enabled: boolean): Promise<void>

设定是否开启同步,使用Promise异步回调。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

enabled

boolean

设定是否开启同步,true表示开启同步,false表示不启用同步。

返回值:

类型

说明

Promise<void>

无返回结果的Promise对象。

示例:

  1. try {
  2. kvStore.enableSync(true).then(() => {
  3. console.info('Succeeded in enabling sync');
  4. }).catch((err) => {
  5. console.error(`Failed to enable sync.code is ${err.code},message is ${err.message}`);
  6. });
  7. } catch (e) {
  8. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  9. }

setSyncRange

setSyncRange(localLabels: string[], remoteSupportLabels: string[], callback: AsyncCallback<void>): void

设置同步范围标签,使用callback异步回调。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

localLabels

string[]

表示本地设备的同步标签。

remoteSupportLabels

string[]

表示要同步数据的设备的同步标签。

callback

AsyncCallback<void>

回调函数。

示例:

  1. try {
  2. const localLabels = ['A', 'B'];
  3. const remoteSupportLabels = ['C', 'D'];
  4. kvStore.setSyncRange(localLabels, remoteSupportLabels, function (err) {
  5. if (err != undefined) {
  6. console.error(`Failed to set syncRange.code is ${err.code},message is ${err.message}`);
  7. return;
  8. }
  9. console.info('Succeeded in setting syncRange');
  10. });
  11. } catch (e) {
  12. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  13. }

setSyncRange

setSyncRange(localLabels: string[], remoteSupportLabels: string[]): Promise<void>

设置同步范围标签,使用Promise异步回调。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

localLabels

string[]

表示本地设备的同步标签。

remoteSupportLabels

string[]

表示要同步数据的设备的同步标签。

返回值:

类型

说明

Promise<void>

无返回结果的Promise对象。

示例:

  1. try {
  2. const localLabels = ['A', 'B'];
  3. const remoteSupportLabels = ['C', 'D'];
  4. kvStore.setSyncRange(localLabels, remoteSupportLabels).then(() => {
  5. console.info('Succeeded in setting syncRange');
  6. }).catch((err) => {
  7. console.error(`Failed to set syncRange.code is ${err.code},message is ${err.message}`);
  8. });
  9. } catch (e) {
  10. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  11. }

setSyncParam

setSyncParam(defaultAllowedDelayMs: number, callback: AsyncCallback<void>): void

设置数据库同步允许的默认延迟,使用callback异步回调。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

defaultAllowedDelayMs

number

表示数据库同步允许的默认延迟,以毫秒为单位。

callback

AsyncCallback<void>

回调函数。

示例:

  1. try {
  2. const defaultAllowedDelayMs = 500;
  3. kvStore.setSyncParam(defaultAllowedDelayMs, function (err) {
  4. if (err != undefined) {
  5. console.error(`Failed to set syncParam.code is ${err.code},message is ${err.message}`);
  6. return;
  7. }
  8. console.info('Succeeded in setting syncParam');
  9. });
  10. } catch (e) {
  11. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  12. }

setSyncParam

setSyncParam(defaultAllowedDelayMs: number): Promise<void>

设置数据库同步允许的默认延迟,使用Promise异步回调。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

defaultAllowedDelayMs

number

表示数据库同步允许的默认延迟,以毫秒为单位。

返回值:

类型

说明

Promise<void>

无返回结果的Promise对象。

示例:

  1. try {
  2. const defaultAllowedDelayMs = 500;
  3. kvStore.setSyncParam(defaultAllowedDelayMs).then(() => {
  4. console.info('Succeeded in setting syncParam');
  5. }).catch((err) => {
  6. console.error(`Failed to set syncParam.code is ${err.code},message is ${err.message}`);
  7. });
  8. } catch (e) {
  9. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  10. }

sync

sync(deviceIds: string[], mode: SyncMode, delayMs?: number): void

在手动同步方式下,触发数据库同步。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

需要权限: ohos.permission.DISTRIBUTED_DATASYNC。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

deviceIds

string[]

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

mode

SyncMode

同步模式。

delayMs

number

可选参数,允许延时时间,单位:ms(毫秒),默认为0。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100004

Not found.

示例:

  1. const KEY_TEST_SYNC_ELEMENT = 'key_test_sync';
  2. const VALUE_TEST_SYNC_ELEMENT = 'value-string-001';
  3. try {
  4. kvStore.on('syncComplete', function (data) {
  5. console.info('Sync dataChange');
  6. });
  7. kvStore.put(KEY_TEST_SYNC_ELEMENT + 'testSync101', VALUE_TEST_SYNC_ELEMENT, function (err) {
  8. if (err != undefined) {
  9. console.error(`Failed to sync.code is ${err.code},message is ${err.message}`);
  10. return;
  11. }
  12. console.info('Succeeded in putting data');
  13. const deviceIds = ['deviceList'];
  14. const mode = distributedKVStore.SyncMode.PULL_ONLY;
  15. kvStore.sync(deviceIds, mode, 1000);
  16. });
  17. } catch (e) {
  18. console.error(`Failed to sync.code is ${e.code},message is ${e.message}`);
  19. }

sync

sync(deviceIds: string[], query: Query, mode: SyncMode, delayMs?: number): void

在手动同步方式下,触发数据库同步,此方法为同步方法。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

需要权限: ohos.permission.DISTRIBUTED_DATASYNC。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

deviceIds

string[]

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

mode

SyncMode

同步模式。

query

Query

表示数据库的查询谓词条件

delayMs

number

可选参数,允许延时时间,单位:ms(毫秒)。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100004

Not found.

示例:

  1. const KEY_TEST_SYNC_ELEMENT = 'key_test_sync';
  2. const VALUE_TEST_SYNC_ELEMENT = 'value-string-001';
  3. try {
  4. kvStore.on('syncComplete', function (data) {
  5. console.info('Sync dataChange');
  6. });
  7. kvStore.put(KEY_TEST_SYNC_ELEMENT + 'testSync101', VALUE_TEST_SYNC_ELEMENT, function (err) {
  8. if (err != undefined) {
  9. console.error(`Failed to sync.code is ${err.code},message is ${err.message}`);
  10. return;
  11. }
  12. console.info('Succeeded in putting data');
  13. const deviceIds = ['deviceList'];
  14. const mode = distributedKVStore.SyncMode.PULL_ONLY;
  15. const query = new distributedKVStore.Query();
  16. query.prefixKey("batch_test");
  17. query.deviceId('localDeviceId');
  18. kvStore.sync(deviceIds, query, mode, 1000);
  19. });
  20. } catch (e) {
  21. console.error(`Failed to sync.code is ${e.code},message is ${e.message}`);
  22. }

on('dataChange')

on(event: 'dataChange', type: SubscribeType, listener: Callback<ChangeNotification>): void

订阅指定类型的数据变更通知。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

event

string

订阅的事件名,固定为'dataChange',表示数据变更事件。

type

SubscribeType

表示订阅的类型。

listener

Callback<ChangeNotification>

回调函数。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100001

Over max subscribe limits.

15100005

Database or result set already closed.

示例:

  1. try {
  2. kvStore.on('dataChange', distributedKVStore.SubscribeType.SUBSCRIBE_TYPE_LOCAL, function (data) {
  3. console.info(`dataChange callback call data: ${data}`);
  4. });
  5. } catch (e) {
  6. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  7. }

on('syncComplete')

on(event: 'syncComplete', syncCallback: Callback<Array<[string, number]>>): void

订阅同步完成事件回调通知。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

event

string

订阅的事件名,固定为'syncComplete',表示同步完成事件。

syncCallback

Callback<Array<[string, number]>>

回调函数。用于向调用方发送同步结果的回调。

示例:

  1. const KEY_TEST_FLOAT_ELEMENT = 'key_test_float';
  2. const VALUE_TEST_FLOAT_ELEMENT = 321.12;
  3. try {
  4. kvStore.on('syncComplete', function (data) {
  5. console.info(`syncComplete ${data}`);
  6. });
  7. kvStore.put(KEY_TEST_FLOAT_ELEMENT, VALUE_TEST_FLOAT_ELEMENT).then(() => {
  8. console.info('succeeded in putting');
  9. }).catch((err) => {
  10. console.error(`Failed to put.code is ${err.code},message is ${err.message}`);
  11. });
  12. } catch (e) {
  13. console.error(`Failed to subscribe syncComplete.code is ${e.code},message is ${e.message}`);
  14. }

off('dataChange')

off(event:'dataChange', listener?: Callback<ChangeNotification>): void

取消订阅数据变更通知。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

event

string

取消订阅的事件名,固定为'dataChange',表示数据变更事件。

listener

Callback<ChangeNotification>

取消订阅的函数。如不设置callback,则取消所有已订阅的函数。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100005

Database or result set already closed.

示例:

  1. class KvstoreModel {
  2. call(data) {
  3. console.info(`dataChange : ${data}`);
  4. }
  5. subscribeDataChange() {
  6. try {
  7. if (kvStore != null) {
  8. kvStore.on('dataChange', distributedKVStore.SubscribeType.SUBSCRIBE_TYPE_REMOTE, this.call);
  9. }
  10. } catch (err) {
  11. console.error(`Failed to subscribeDataChange.code is ${err.code},message is ${err.message}`);
  12. }
  13. }
  14. unsubscribeDataChange() {
  15. try {
  16. if (kvStore != null) {
  17. kvStore.off('dataChange', this.call);
  18. }
  19. } catch (err) {
  20. console.error(`Failed to unsubscribeDataChange.code is ${err.code},message is ${err.message}`);
  21. }
  22. }
  23. }

off('syncComplete')

off(event: 'syncComplete', syncCallback?: Callback<Array<[string, number]>>): void

取消订阅同步完成事件回调通知。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

event

string

取消订阅的事件名,固定为'syncComplete',表示同步完成事件。

syncCallback

Callback<Array<[string, number]>>

取消订阅的函数。如不设置callback,则取消所有已订阅的函数。

示例:

  1. class KvstoreModel {
  2. call(data) {
  3. console.info(`syncComplete : ${data}`);
  4. }
  5. subscribeDataChange() {
  6. try {
  7. if (kvStore != null) {
  8. kvStore.on('syncComplete', distributedKVStore.SubscribeType.SUBSCRIBE_TYPE_REMOTE, this.call);
  9. }
  10. } catch (err) {
  11. console.error(`Failed to subscribeDataChange.code is ${err.code},message is ${err.message}`);
  12. }
  13. }
  14. unsubscribeDataChange() {
  15. try {
  16. if (kvStore != null) {
  17. kvStore.off('dsyncComplete', this.call);
  18. }
  19. } catch (err) {
  20. console.error(`Failed to unsubscribeDataChange.code is ${err.code},message is ${err.message}`);
  21. }
  22. }
  23. }

getSecurityLevel

getSecurityLevel(callback: AsyncCallback<SecurityLevel>): void

获取数据库的安全级别,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

callback

AsyncCallback<SecurityLevel>

回调函数。返回数据库的安全级别。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100005

Database or result set already closed.

示例:

  1. try {
  2. kvStore.getSecurityLevel(function (err, data) {
  3. if (err != undefined) {
  4. console.error(`Failed to get SecurityLevel.code is ${err.code},message is ${err.message}`);
  5. return;
  6. }
  7. console.info('Succeeded in getting securityLevel');
  8. });
  9. } catch (e) {
  10. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  11. }

getSecurityLevel

getSecurityLevel(): Promise<SecurityLevel>

获取数据库的安全级别,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

返回值:

类型

说明

Promise<SecurityLevel>

Promise对象。返回数据库的安全级别。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100005

Database or result set already closed.

示例:

  1. try {
  2. kvStore.getSecurityLevel().then((data) => {
  3. console.info('Succeeded in getting securityLevel');
  4. }).catch((err) => {
  5. console.error(`Failed to get SecurityLevel.code is ${err.code},message is ${err.message}`);
  6. });
  7. } catch (e) {
  8. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  9. }

DeviceKVStore

设备协同数据库,继承自SingleKVStore,提供查询数据和同步数据的方法。

设备协同数据库,以设备维度对数据进行区分,每台设备仅能写入和修改本设备的数据,其它设备的数据对其是只读的,无法修改其它设备的数据。

比如,可以使用设备协同数据库实现设备间的图片分享,可以查看其他设备的图片,但无法修改和删除其他设备的图片。

在调用DeviceKVStore的方法前,需要先通过getKVStore构建一个DeviceKVStore实例。

get

get(key: string, callback: AsyncCallback<boolean | string | number | Uint8Array>): void

获取本设备指定键的值,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

key

string

要查询数据的key,不能为空且长度不大于MAX_KEY_LENGTH

callback

AsyncCallback<boolean | string | number | Uint8Array>

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

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100004

Not found.

15100005

Database or result set already closed.

示例:

  1. const KEY_TEST_STRING_ELEMENT = 'key_test_string';
  2. const VALUE_TEST_STRING_ELEMENT = 'value-test-string';
  3. try {
  4. kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT, function (err) {
  5. if (err != undefined) {
  6. console.error(`Failed to put.code is ${err.code},message is ${err.message}`);
  7. return;
  8. }
  9. console.info("Succeeded in putting");
  10. kvStore.get(KEY_TEST_STRING_ELEMENT, function (err, data) {
  11. if (err != undefined) {
  12. console.error(`Failed to get.code is ${err.code},message is ${err.message}`);
  13. return;
  14. }
  15. console.info(`Succeeded in getting data.data=${data}`);
  16. });
  17. });
  18. } catch (e) {
  19. console.error(`Failed to get.code is ${e.code},message is ${e.message}`);
  20. }

get

get(key: string): Promise<boolean | string | number | Uint8Array>

获取本设备指定键的值,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

key

string

要查询数据的key,不能为空且长度不大于MAX_KEY_LENGTH

返回值:

类型

说明

Promise<Uint8Array | string | boolean | number>

Promise对象。返回获取查询的值。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100004

Not found.

15100005

Database or result set already closed.

示例:

  1. const KEY_TEST_STRING_ELEMENT = 'key_test_string';
  2. const VALUE_TEST_STRING_ELEMENT = 'value-test-string';
  3. try {
  4. kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT).then(() => {
  5. console.info(`Succeeded in putting data.data=${data}`);
  6. kvStore.get(KEY_TEST_STRING_ELEMENT).then((data) => {
  7. console.info(`Succeeded in getting data.data=${data}`);
  8. }).catch((err) => {
  9. console.error(`Failed to get.code is ${err.code},message is ${err.message}`);
  10. });
  11. }).catch((err) => {
  12. console.error(`Failed to put.code is ${err.code},message is ${err.message}`);
  13. });
  14. } catch (e) {
  15. console.error(`Failed to get.code is ${e.code},message is ${e.message}`);
  16. }

get

get(deviceId: string, key: string, callback: AsyncCallback<boolean | string | number | Uint8Array>): void

获取与指定设备ID和key匹配的string值,使用callback异步回调。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.DistributedKVStore

参数:

参数名

类型

必填

说明

deviceId

string

标识要查询其数据的设备。

key

string

表示要查询key值的键。

callback

AsyncCallback<boolean|string|number|Uint8Array>

回调函数,返回匹配给定条件的字符串值。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100004

Not found.

15100005

Database or result set already closed.

示例:

  1. const KEY_TEST_STRING_ELEMENT = 'key_test_string_2';
  2. const VALUE_TEST_STRING_ELEMENT = 'value-string-002';
  3. try {
  4. kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT, async function (err) {
  5. if (err != undefined) {
  6. console.error(`Failed to put.code is ${err.code},message is ${err.message}`);
  7. return;
  8. }
  9. console.info('Succeeded in putting');
  10. kvStore.get('localDeviceId', KEY_TEST_STRING_ELEMENT, function (err, data) {
  11. if (err != undefined) {
  12. console.error(`Failed to get.code is ${err.code},message is ${err.message}`);
  13. return;
  14. }
  15. console.info('Succeeded in getting');
  16. });
  17. })
  18. } catch (e) {
  19. console.error(`Failed to get.code is ${e.code},message is ${e.message}`);
  20. }

get

get(deviceId: string, key: string): Promise<boolean | string | number | Uint8Array>

获取与指定设备ID和key匹配的string值,使用Promise异步回调。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.DistributedKVStore

参数:

参数名

类型

必填

说明

deviceId

string

标识要查询其数据的设备。

key

string

表示要查询key值的键。

返回值:

类型

说明

Promise<boolean|string|number|Uint8Array>

Promise对象。返回匹配给定条件的字符串值。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100004

Not found.

15100005

Database or result set already closed.

示例:

  1. const KEY_TEST_STRING_ELEMENT = 'key_test_string_2';
  2. const VALUE_TEST_STRING_ELEMENT = 'value-string-002';
  3. try {
  4. kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT).then(async () => {
  5. console.info('Succeeded in putting');
  6. kvStore.get('localDeviceId', KEY_TEST_STRING_ELEMENT).then((data) => {
  7. console.info('Succeeded in getting');
  8. }).catch((err) => {
  9. console.error(`Failed to get.code is ${err.code},message is ${err.message}`);
  10. });
  11. }).catch((error) => {
  12. console.error(`Failed to put.code is ${error.code},message is ${error.message}`);
  13. });
  14. } catch (e) {
  15. console.error(`Failed to get.code is ${e.code},message is ${e.message}`);
  16. }

getEntries

getEntries(keyPrefix: string, callback: AsyncCallback<Entry[]>): void

获取匹配本设备指定键前缀的所有键值对,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

keyPrefix

string

表示要匹配的键前缀。

callback

AsyncCallback<Entry[]>

回调函数。返回匹配指定前缀的键值对列表。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let entries = [];
  3. for (var i = 0; i < 10; i++) {
  4. var key = 'batch_test_string_key';
  5. var entry = {
  6. key: key + i,
  7. value: {
  8. type: distributedKVStore.ValueType.STRING,
  9. value: 'batch_test_string_value'
  10. }
  11. }
  12. entries.push(entry);
  13. }
  14. console.info(`entries: ${entries}`);
  15. kvStore.putBatch(entries, async function (err) {
  16. if (err != undefined) {
  17. console.error(`Failed to put Batch.code is ${err.code},message is ${err.message}`);
  18. return;
  19. }
  20. console.info('Succeeded in putting Batch');
  21. kvStore.getEntries('batch_test_string_key', function (err, entries) {
  22. if (err != undefined) {
  23. console.error(`Failed to get Entries.code is ${err.code},message is ${err.message}`);
  24. return;
  25. }
  26. console.info('Succeeded in getting Entries');
  27. console.info(`entries.length: ${entries.length}`);
  28. console.info(`entries[0]: ${entries[0]}`);
  29. });
  30. });
  31. } catch (e) {
  32. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message} `);
  33. }

getEntries

getEntries(keyPrefix: string): Promise<Entry[]>

获取匹配本设备指定键前缀的所有键值对,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

keyPrefix

string

表示要匹配的键前缀。

返回值:

类型

说明

Promise<Entry[]>

Promise对象。返回匹配指定前缀的键值对列表。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let entries = [];
  3. for (var i = 0; i < 10; i++) {
  4. var key = 'batch_test_string_key';
  5. var entry = {
  6. key: key + i,
  7. value: {
  8. type: distributedKVStore.ValueType.STRING,
  9. value: 'batch_test_string_value'
  10. }
  11. }
  12. entries.push(entry);
  13. }
  14. console.info(`entries: ${entries}`);
  15. kvStore.putBatch(entries).then(async () => {
  16. console.info('Succeeded in putting Batch');
  17. kvStore.getEntries('batch_test_string_key').then((entries) => {
  18. console.info('Succeeded in getting Entries');
  19. console.info(`PutBatch ${entries}`);
  20. }).catch((err) => {
  21. console.error(`Failed to get Entries.code is ${err.code},message is ${err.message}`);
  22. });
  23. }).catch((err) => {
  24. console.error(`Failed to put Batch.code is ${err.code},message is ${err.message}`);
  25. });
  26. } catch (e) {
  27. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message} `);
  28. }

getEntries

getEntries(deviceId: string, keyPrefix: string, callback: AsyncCallback<Entry[]>): void

获取与指定设备ID和key前缀匹配的所有键值对,使用callback异步回调。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.DistributedKVStore

参数:

参数名

类型

必填

说明

deviceId

string

标识要查询其数据的设备。

keyPrefix

string

表示要匹配的键前缀。

callback

AsyncCallback<Entry[]>

回调函数,返回满足给定条件的所有键值对的列表。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let entries = [];
  3. for (var i = 0; i < 10; i++) {
  4. var key = 'batch_test_string_key';
  5. var entry = {
  6. key: key + i,
  7. value: {
  8. type: distributedKVStore.ValueType.STRING,
  9. value: 'batch_test_string_value'
  10. }
  11. }
  12. entries.push(entry);
  13. }
  14. console.info(`entries : ${entries}`);
  15. kvStore.putBatch(entries, async function (err) {
  16. if (err != undefined) {
  17. console.error(`Failed to put batch.code is ${err.code},message is ${err.message}`);
  18. return;
  19. }
  20. console.info('Succeeded in putting batch');
  21. kvStore.getEntries('localDeviceId', 'batch_test_string_key', function (err, entries) {
  22. if (err != undefined) {
  23. console.error(`Failed to get entries.code is ${err.code},message is ${err.message}`);
  24. return;
  25. }
  26. console.info('Succeeded in getting entries');
  27. console.info(`entries.length: ${entries.length}`);
  28. console.info(`entries[0]: ${entries[0]}`);
  29. });
  30. });
  31. } catch (e) {
  32. console.error(`Failed to put batch.code is ${e.code},message is ${e.message}`);
  33. }

getEntries

getEntries(deviceId: string, keyPrefix: string): Promise<Entry[]>

获取与指定设备ID和key前缀匹配的所有键值对,使用Promise异步回调。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.DistributedKVStore

参数:

参数名

类型

必填

说明

deviceId

string

标识要查询其数据的设备。

keyPrefix

string

表示要匹配的键前缀。

返回值:

类型

说明

Promise<Entry[]>

Promise对象。返回匹配给定条件的所有键值对的列表。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let entries = [];
  3. for (var i = 0; i < 10; i++) {
  4. var key = 'batch_test_string_key';
  5. var entry = {
  6. key: key + i,
  7. value: {
  8. type: distributedKVStore.ValueType.STRING,
  9. value: 'batch_test_string_value'
  10. }
  11. }
  12. entries.push(entry);
  13. }
  14. console.info(`entries: ${entries}`);
  15. kvStore.putBatch(entries).then(async () => {
  16. console.info('Succeeded in putting batch');
  17. kvStore.getEntries('localDeviceId', 'batch_test_string_key').then((entries) => {
  18. console.info('Succeeded in getting entries');
  19. console.info(`entries.length: ${entries.length}`);
  20. console.info(`entries[0]: ${entries[0]}`);
  21. console.info(`entries[0].value: ${entries[0].value}`);
  22. console.info(`entries[0].value.value: ${entries[0].value.value}`);
  23. }).catch((err) => {
  24. console.error(`Failed to get entries.code is ${err.code},message is ${err.message}`);
  25. });
  26. }).catch((err) => {
  27. console.error(`Failed to put batch.code is ${err.code},message is ${err.message}`);
  28. });
  29. } catch (e) {
  30. console.error(`Failed to put batch.code is ${e.code},message is ${e.message}`);
  31. }

getEntries

getEntries(query: Query, callback: AsyncCallback<Entry[]>): void

获取本设备与指定Query对象匹配的键值对列表,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

query

Query

表示要匹配的键前缀。

callback

AsyncCallback<Entry[]>

回调函数。返回本设备与指定Query对象匹配的键值对列表。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. var arr = new Uint8Array([21, 31]);
  3. let entries = [];
  4. for (var i = 0; i < 10; i++) {
  5. var key = 'batch_test_bool_key';
  6. var entry = {
  7. key: key + i,
  8. value: {
  9. type: distributedKVStore.ValueType.BYTE_ARRAY,
  10. value: arr
  11. }
  12. }
  13. entries.push(entry);
  14. }
  15. console.info(`entries: {entries}`);
  16. kvStore.putBatch(entries, async function (err) {
  17. console.info('Succeeded in putting Batch');
  18. const query = new distributedKVStore.Query();
  19. query.prefixKey("batch_test");
  20. kvStore.getEntries(query, function (err, entries) {
  21. if (err != undefined) {
  22. console.error(`Failed to get Entries.code is ${err.code},message is ${err.message}`);
  23. return;
  24. }
  25. console.info('Succeeded in getting Entries');
  26. console.info(`entries.length: ${entries.length}`);
  27. console.info(`entries[0]: ${entries[0]}`);
  28. });
  29. });
  30. } catch (e) {
  31. console.error(`Failed to get Entries.code is ${e.code},message is ${e.message}`);
  32. }

getEntries

getEntries(query: Query): Promise<Entry[]>

获取本设备与指定Query对象匹配的键值对列表,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

query

Query

表示查询对象。

返回值:

类型

说明

Promise<Entry[]>

Promise对象。返回本设备与指定Query对象匹配的键值对列表。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. var arr = new Uint8Array([21, 31]);
  3. let entries = [];
  4. for (var i = 0; i < 10; i++) {
  5. var key = 'batch_test_bool_key';
  6. var entry = {
  7. key: key + i,
  8. value: {
  9. type: distributedKVStore.ValueType.BYTE_ARRAY,
  10. value: arr
  11. }
  12. }
  13. entries.push(entry);
  14. }
  15. console.info(`entries: {entries}`);
  16. kvStore.putBatch(entries).then(async () => {
  17. console.info('Succeeded in putting Batch');
  18. const query = new distributedKVStore.Query();
  19. query.prefixKey("batch_test");
  20. kvStore.getEntries(query).then((entries) => {
  21. console.info('Succeeded in getting Entries');
  22. }).catch((err) => {
  23. console.error(`Failed to get Entries.code is ${err.code},message is ${err.message}`);
  24. });
  25. }).catch((err) => {
  26. console.error(`Failed to get Entries.code is ${err.code},message is ${err.message}`)
  27. });
  28. console.info('Succeeded in getting Entries');
  29. } catch (e) {
  30. console.error(`Failed to get Entries.code is ${e.code},message is ${e.message}`);
  31. }

getEntries

getEntries(deviceId: string, query: Query, callback: AsyncCallback<Entry[]>): void

获取与指定设备ID和Query对象匹配的键值对列表,使用callback异步回调。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.DistributedKVStore

参数:

参数名

类型

必填

说明

deviceId

string

键值对所属的设备ID。

query

Query

表示查询对象。

callback

AsyncCallback<Entry[]>

回调函数。返回与指定设备ID和Query对象匹配的键值对列表。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. var arr = new Uint8Array([21, 31]);
  3. let entries = [];
  4. for (var i = 0; i < 10; i++) {
  5. var key = 'batch_test_bool_key';
  6. var entry = {
  7. key: key + i,
  8. value: {
  9. type: distributedKVStore.ValueType.BYTE_ARRAY,
  10. value: arr
  11. }
  12. }
  13. entries.push(entry);
  14. }
  15. console.info(`entries: ${entries}`);
  16. kvStore.putBatch(entries, async function (err) {
  17. if (err != undefined) {
  18. console.error(`Failed to put batch.code is ${err.code},message is ${err.message}`);
  19. return;
  20. }
  21. console.info('Succeeded in putting batch');
  22. var query = new distributedKVStore.Query();
  23. query.deviceId('localDeviceId');
  24. query.prefixKey("batch_test");
  25. kvStore.getEntries('localDeviceId', query, function (err, entries) {
  26. if (err != undefined) {
  27. console.error(`Failed to get entries.code is ${err.code},message is ${err.message}`);
  28. return;
  29. }
  30. console.info('Succeeded in getting entries');
  31. console.info(`entries.length: ${entries.length}`);
  32. console.info(`entries[0]: ${entries[0]}`);
  33. })
  34. });
  35. console.info('Succeeded in getting entries');
  36. } catch (e) {
  37. console.error(`Failed to get entries.code is ${e.code},message is ${e.message}`);
  38. }

getEntries

getEntries(deviceId: string, query: Query): Promise<Entry[]>

获取与指定设备ID和Query对象匹配的键值对列表,使用Promise异步回调。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.DistributedKVStore

参数:

参数名

类型

必填

说明

deviceId

string

键值对所属的设备ID。

query

Query

表示查询对象。

返回值:

类型

说明

Promise<Entry[]>

Promise对象。返回与指定设备ID和Query对象匹配的键值对列表。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. var arr = new Uint8Array([21, 31]);
  3. let entries = [];
  4. for (var i = 0; i < 10; i++) {
  5. var key = 'batch_test_bool_key';
  6. var entry = {
  7. key: key + i,
  8. value: {
  9. type: distributedKVStore.ValueType.BYTE_ARRAY,
  10. value: arr
  11. }
  12. }
  13. entries.push(entry);
  14. }
  15. console.info(`entries: ${entries}`);
  16. kvStore.putBatch(entries).then(async () => {
  17. console.info('Succeeded in putting batch');
  18. var query = new distributedKVStore.Query();
  19. query.deviceId('localDeviceId');
  20. query.prefixKey("batch_test");
  21. kvStore.getEntries('localDeviceId', query).then((entries) => {
  22. console.info('Succeeded in getting entries');
  23. }).catch((err) => {
  24. console.error(`Failed to get entries.code is ${err.code},message is ${err.message}`);
  25. });
  26. }).catch((err) => {
  27. console.error(`Failed to put batch.code is ${err.code},message is ${err.message}`);
  28. });
  29. console.info('Succeeded in getting entries');
  30. } catch (e) {
  31. console.error(`Failed to get entries.code is ${e.code},message is ${e.message}`);
  32. }

getResultSet

getResultSet(keyPrefix: string, callback: AsyncCallback<KVStoreResultSet>): void

从DeviceKVStore数据库中获取本设备具有指定前缀的结果集,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

keyPrefix

string

表示要匹配的键前缀。

callback

AsyncCallback<KVStoreResultSet>

回调函数。返回具有指定前缀的结果集。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let resultSet;
  3. let entries = [];
  4. for (var i = 0; i < 10; i++) {
  5. var key = 'batch_test_string_key';
  6. var entry = {
  7. key: key + i,
  8. value: {
  9. type: distributedKVStore.ValueType.STRING,
  10. value: 'batch_test_string_value'
  11. }
  12. }
  13. entries.push(entry);
  14. }
  15. kvStore.putBatch(entries, async function (err) {
  16. if (err != undefined) {
  17. console.error(`Failed to put batch.code is ${err.code},message is ${err.message}`);
  18. return;
  19. }
  20. console.info('Succeeded in putting batch');
  21. kvStore.getResultSet('batch_test_string_key', async function (err, result) {
  22. if (err != undefined) {
  23. console.error(`Failed to get resultset.code is ${err.code},message is ${err.message}`);
  24. return;
  25. }
  26. console.info('Succeeded in getting result set');
  27. resultSet = result;
  28. kvStore.closeResultSet(resultSet, function (err) {
  29. if (err != undefined) {
  30. console.error(`Failed to close resultset.code is ${err.code},message is ${err.message}`);
  31. return;
  32. }
  33. console.info('Succeeded in closing result set');
  34. })
  35. });
  36. });
  37. } catch (e) {
  38. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.message}`);
  39. }

getResultSet

getResultSet(keyPrefix: string): Promise<KVStoreResultSet>

从DeviceKVStore数据库中获取本设备具有指定前缀的结果集,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

keyPrefix

string

表示要匹配的键前缀。

返回值:

类型

说明

Promise<KVStoreResultSet>

Promise对象。返回具有指定前缀的结果集。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let resultSet;
  3. let entries = [];
  4. for (var i = 0; i < 10; i++) {
  5. var key = 'batch_test_string_key';
  6. var entry = {
  7. key: key + i,
  8. value: {
  9. type: distributedKVStore.ValueType.STRING,
  10. value: 'batch_test_string_value'
  11. }
  12. }
  13. entries.push(entry);
  14. }
  15. kvStore.putBatch(entries).then(async () => {
  16. console.info('Succeeded in putting batch');
  17. }).catch((err) => {
  18. console.error(`Failed to put batch.code is ${err.code},message is ${err.message}`);
  19. });
  20. kvStore.getResultSet('batch_test_string_key').then((result) => {
  21. console.info('Succeeded in getting result set');
  22. resultSet = result;
  23. }).catch((err) => {
  24. console.error(`Failed to get resultset.code is ${err.code},message is ${err.message}`);
  25. });
  26. kvStore.closeResultSet(resultSet).then(() => {
  27. console.info('Succeeded in closing result set');
  28. }).catch((err) => {
  29. console.error(`Failed to close resultset.code is ${err.code},message is ${err.message}`);
  30. });
  31. } catch (e) {
  32. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.code}`);
  33. }

getResultSet

getResultSet(deviceId: string, keyPrefix: string, callback: AsyncCallback<KVStoreResultSet>): void

获取与指定设备ID和key前缀匹配的KVStoreResultSet对象,使用callback异步回调。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.DistributedKVStore

参数:

参数名

类型

必填

说明

deviceId

string

标识要查询其数据的设备。

keyPrefix

string

表示要匹配的键前缀。

callback

AsyncCallback<KVStoreResultSet>

回调函数。返回与指定设备ID和key前缀匹配的KVStoreResultSet对象。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let resultSet;
  3. kvStore.getResultSet('localDeviceId', 'batch_test_string_key', async function (err, result) {
  4. if (err != undefined) {
  5. console.error(`Failed to get resultSet.code is ${err.code},message is ${err.message}`);
  6. return;
  7. }
  8. console.info('Succeeded in getting resultSet');
  9. resultSet = result;
  10. kvStore.closeResultSet(resultSet, function (err) {
  11. if (err != undefined) {
  12. console.error(`Failed to close resultSet.code is ${err.code},message is ${err.message}`);
  13. return;
  14. }
  15. console.info('Succeeded in closing resultSet');
  16. })
  17. });
  18. } catch (e) {
  19. console.error(`Failed to get resultSet.code is ${e.code},message is ${e.message}`);
  20. }

getResultSet

getResultSet(deviceId: string, keyPrefix: string): Promise<KVStoreResultSet>

获取与指定设备ID和key前缀匹配的KVStoreResultSet对象,使用Promise异步回调。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.DistributedKVStore

参数:

参数名

类型

必填

说明

deviceId

string

标识要查询其数据的设备。

keyPrefix

string

表示要匹配的键前缀。

返回值:

类型

说明

Promise<KVStoreResultSet>

Promise对象。返回与指定设备ID和key前缀匹配的KVStoreResultSet对象。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let resultSet;
  3. kvStore.getResultSet('localDeviceId', 'batch_test_string_key').then((result) => {
  4. console.info('Succeeded in getting resultSet');
  5. resultSet = result;
  6. }).catch((err) => {
  7. console.error(`Failed to get resultSet.code is ${err.code},message is ${err.message}`);
  8. });
  9. kvStore.closeResultSet(resultSet).then(() => {
  10. console.info('Succeeded in closing resultSet');
  11. }).catch((err) => {
  12. console.error(`Failed to close resultSet.code is ${err.code},message is ${err.message}`);
  13. });
  14. } catch (e) {
  15. console.error(`Failed to get resultSet.code is ${e.code},message is ${e.message}`);
  16. }

getResultSet

getResultSet(deviceId: string, query: Query, callback: AsyncCallback<KVStoreResultSet>): void

获取与指定设备ID和Query对象匹配的KVStoreResultSet对象,使用callback异步回调。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.DistributedKVStore

参数:

参数名

类型

必填

说明

deviceId

string

KVStoreResultSet对象所属的设备ID。

query

Query

表示查询对象。

callback

AsyncCallback<KVStoreResultSet>

回调函数。返回与指定设备ID和Query对象匹配的KVStoreResultSet对象。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let resultSet;
  3. let entries = [];
  4. for (var i = 0; i < 10; i++) {
  5. var key = 'batch_test_string_key';
  6. var entry = {
  7. key: key + i,
  8. value: {
  9. type: distributedKVStore.ValueType.STRING,
  10. value: 'batch_test_string_value'
  11. }
  12. }
  13. entries.push(entry);
  14. }
  15. kvStore.putBatch(entries, async function (err) {
  16. if (err != undefined) {
  17. console.error(`Failed to put batch.code is ${err.code},message is ${err.message}`);
  18. return;
  19. }
  20. console.info('Succeeded in putting batch');
  21. const query = new distributedKVStore.Query();
  22. query.prefixKey("batch_test");
  23. kvStore.getResultSet('localDeviceId', query, async function (err, result) {
  24. if (err != undefined) {
  25. console.error(`Failed to get resultSet.code is ${err.code},message is ${err.message}`);
  26. return;
  27. }
  28. console.info('Succeeded in getting resultSet');
  29. resultSet = result;
  30. kvStore.closeResultSet(resultSet, function (err) {
  31. if (err != undefined) {
  32. console.error(`Failed to close resultSet.code is ${err.code},message is ${err.message}`);
  33. return;
  34. }
  35. console.info('Succeeded in closing resultSet');
  36. })
  37. });
  38. });
  39. } catch (e) {
  40. console.error(`Failed to get resultSet.code is ${e.code},message is ${e.message}`);
  41. }

getResultSet

getResultSet(deviceId: string, query: Query): Promise<KVStoreResultSet>

获取与指定设备ID和Query对象匹配的KVStoreResultSet对象,使用Promise异步回调。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.DistributedKVStore

参数:

参数名

类型

必填

说明

deviceId

string

KVStoreResultSet对象所属的设备ID。

query

Query

表示查询对象。

返回值:

类型

说明

Promise<KVStoreResultSet>

Promise对象。返回与指定设备ID和Query对象匹配的KVStoreResultSet对象。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let resultSet;
  3. let entries = [];
  4. for (var i = 0; i < 10; i++) {
  5. var key = 'batch_test_string_key';
  6. var entry = {
  7. key: key + i,
  8. value: {
  9. type: distributedKVStore.ValueType.STRING,
  10. value: 'batch_test_string_value'
  11. }
  12. }
  13. entries.push(entry);
  14. }
  15. kvStore.putBatch(entries).then(async () => {
  16. console.info('Succeeded in putting batch');
  17. }).catch((err) => {
  18. console.error(`Failed to put batch.code is ${err.code},message is ${err.message}`);
  19. });
  20. const query = new distributedKVStore.Query();
  21. query.prefixKey("batch_test");
  22. kvStore.getResultSet('localDeviceId', query).then((result) => {
  23. console.info('Succeeded in getting resultSet');
  24. resultSet = result;
  25. }).catch((err) => {
  26. console.error(`Failed to get resultSet.code is ${err.code},message is ${err.message}`);
  27. });
  28. query.deviceId('localDeviceId');
  29. console.info("GetResultSet " + query.getSqlLike());
  30. kvStore.closeResultSet(resultSet).then(() => {
  31. console.info('Succeeded in closing resultSet');
  32. }).catch((err) => {
  33. console.error(`Failed to close resultSet.code is ${err.code},message is ${err.message}`);
  34. });
  35. } catch (e) {
  36. console.error(`Failed to get resultSet.code is ${e.code},message is ${e.message}`);
  37. }

getResultSet

getResultSet(query: Query): Promise<KVStoreResultSet>

获取与本设备指定Query对象匹配的KVStoreResultSet对象,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

query

Query

表示查询对象。

返回值:

类型

说明

Promise<KVStoreResultSet>

Promise对象。获取与本设备指定Query对象匹配的KVStoreResultSet对象。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let resultSet;
  3. let entries = [];
  4. for (var i = 0; i < 10; i++) {
  5. var key = 'batch_test_string_key';
  6. var entry = {
  7. key: key + i,
  8. value: {
  9. type: distributedKVStore.ValueType.STRING,
  10. value: 'batch_test_string_value'
  11. }
  12. }
  13. entries.push(entry);
  14. }
  15. kvStore.putBatch(entries).then(async () => {
  16. console.info('Succeeded in putting batch');
  17. }).catch((err) => {
  18. console.error(`Failed to put batch.code is ${err.code},message is ${err.message}`);
  19. });
  20. const query = new distributedKVStore.Query();
  21. query.prefixKey("batch_test");
  22. kvStore.getResultSet(query).then((result) => {
  23. console.info('Succeeded in getting result set');
  24. resultSet = result;
  25. }).catch((err) => {
  26. console.error(`Failed to get resultset.code is ${err.code},message is ${err.message}`);
  27. });
  28. } catch (e) {
  29. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.code}`);
  30. }

getResultSet

getResultSet(query: Query, callback:AsyncCallback<KVStoreResultSet>): void

获取与本设备指定Query对象匹配的KVStoreResultSet对象,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

query

Query

表示查询对象。

callback

AsyncCallback<KVStoreResultSet>

回调函数,获取与指定Predicates对象匹配的KVStoreResultSet对象。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let resultSet;
  3. let entries = [];
  4. for (var i = 0; i < 10; i++) {
  5. var key = 'batch_test_string_key';
  6. var entry = {
  7. key: key + i,
  8. value: {
  9. type: distributedKVStore.ValueType.STRING,
  10. value: 'batch_test_string_value'
  11. }
  12. }
  13. entries.push(entry);
  14. }
  15. kvStore.putBatch(entries, async function (err) {
  16. if (err != undefined) {
  17. console.error(`Failed to put batch.code is ${err.code},message is ${err.message}`);
  18. return;
  19. }
  20. console.info('Succeeded in putting batch');
  21. const query = new distributedKVStore.Query();
  22. query.prefixKey("batch_test");
  23. kvStore.getResultSet(query, async function (err, result) {
  24. if (err != undefined) {
  25. console.error(`Failed to get resultSet.code is ${err.code},message is ${err.message}`);
  26. return;
  27. }
  28. console.info('Succeeded in getting resultSet');
  29. resultSet = result;
  30. kvStore.closeResultSet(resultSet, function (err) {
  31. if (err != undefined) {
  32. console.error(`Failed to close resultSet.code is ${err.code},message is ${err.message}`);
  33. return;
  34. }
  35. console.info('Succeeded in closing resultSet');
  36. })
  37. });
  38. });
  39. } catch (e) {
  40. console.error(`Failed to get resultSet.code is ${e.code},message is ${e.message}`);
  41. }

getResultSize

getResultSize(query: Query, callback: AsyncCallback<number>): void

获取与本设备指定Query对象匹配的结果数,使用callback异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

query

Query

表示查询对象。

callback

AsyncCallback<number>

回调函数。返回与本设备指定Query对象匹配的结果数。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let entries = [];
  3. for (var i = 0; i < 10; i++) {
  4. var key = 'batch_test_string_key';
  5. var entry = {
  6. key: key + i,
  7. value: {
  8. type: distributedKVStore.ValueType.STRING,
  9. value: 'batch_test_string_value'
  10. }
  11. }
  12. entries.push(entry);
  13. }
  14. kvStore.putBatch(entries, async function (err) {
  15. console.info('Succeeded in putting batch');
  16. const query = new distributedKVStore.Query();
  17. query.prefixKey("batch_test");
  18. kvStore.getResultSize(query, async function (err, resultSize) {
  19. if (err != undefined) {
  20. console.error(`Failed to get result size.code is ${err.code},message is ${err.message}`);
  21. return;
  22. }
  23. console.info('Succeeded in getting result set size');
  24. });
  25. });
  26. } catch (e) {
  27. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.code}`);
  28. }

getResultSize

getResultSize(query: Query): Promise<number>

获取与本设备指定Query对象匹配的结果数,使用Promise异步回调。

系统能力: SystemCapability.DistributedDataManager.KVStore.Core

参数:

参数名

类型

必填

说明

query

Query

表示查询对象。

返回值:

类型

说明

Promise<number>

Promise对象。获取与本设备指定Query对象匹配的结果数。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let entries = [];
  3. for (var i = 0; i < 10; i++) {
  4. var key = 'batch_test_string_key';
  5. var entry = {
  6. key: key + i,
  7. value: {
  8. type: distributedKVStore.ValueType.STRING,
  9. value: 'batch_test_string_value'
  10. }
  11. }
  12. entries.push(entry);
  13. }
  14. kvStore.putBatch(entries).then(async () => {
  15. console.info('Succeeded in putting batch');
  16. }).catch((err) => {
  17. console.error(`Failed to put batch.code is ${err.code},message is ${err.message}`);
  18. });
  19. const query = new distributedKVStore.Query();
  20. query.prefixKey("batch_test");
  21. kvStore.getResultSize(query).then((resultSize) => {
  22. console.info('Succeeded in getting result set size');
  23. }).catch((err) => {
  24. console.error(`Failed to get result size.code is ${err.code},message is ${err.message}`);
  25. });
  26. } catch (e) {
  27. console.error(`An unexpected error occurred.code is ${e.code},message is ${e.code}`);
  28. }

getResultSize

getResultSize(deviceId: string, query: Query, callback: AsyncCallback<number>): void;

获取与指定设备ID和Query对象匹配的结果数,使用callback异步回调。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.DistributedKVStore

参数:

参数名

类型

必填

说明

deviceId

string

KVStoreResultSet对象所属的设备ID。

query

Query

表示查询对象。

callback

AsyncCallback<number>

回调函数。返回与指定设备ID和Query对象匹配的结果数。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let entries = [];
  3. for (var i = 0; i < 10; i++) {
  4. var key = 'batch_test_string_key';
  5. var entry = {
  6. key: key + i,
  7. value: {
  8. type: distributedKVStore.ValueType.STRING,
  9. value: 'batch_test_string_value'
  10. }
  11. }
  12. entries.push(entry);
  13. }
  14. kvStore.putBatch(entries, async function (err) {
  15. if (err != undefined) {
  16. console.error(`Failed to put batch.code is ${err.code},message is ${err.message}`);
  17. return;
  18. }
  19. console.info('Succeeded in putting batch');
  20. const query = new distributedKVStore.Query();
  21. query.prefixKey("batch_test");
  22. kvStore.getResultSize('localDeviceId', query, async function (err, resultSize) {
  23. if (err != undefined) {
  24. console.error(`Failed to get resultSize.code is ${err.code},message is ${err.message}`);
  25. return;
  26. }
  27. console.info('Succeeded in getting resultSize');
  28. });
  29. });
  30. } catch (e) {
  31. console.error(`Failed to get resultSize.code is ${e.code},message is ${e.message}`);
  32. }

getResultSize

getResultSize(deviceId: string, query: Query): Promise<number>

获取与指定设备ID和Query对象匹配的结果数,使用Promise异步回调。

说明

此接口能力在HarmonyOS 3.1Release暂不支持。

系统能力: SystemCapability.DistributedDataManager.KVStore.DistributedKVStore

参数:

参数名

类型

必填

说明

deviceId

string

KVStoreResultSet对象所属的设备ID。

query

Query

表示查询对象。

返回值:

类型

说明

Promise<number>

Promise对象。返回与指定设备ID和Query对象匹配的结果数。

错误码:

以下错误码的详细介绍请参见分布式键值数据库错误码

错误码ID

错误信息

15100003

Database corrupted.

15100005

Database or result set already closed.

示例:

  1. try {
  2. let entries = [];
  3. for (var i = 0; i < 10; i++) {
  4. var key = 'batch_test_string_key';
  5. var entry = {
  6. key: key + i,
  7. value: {
  8. type: distributedKVStore.ValueType.STRING,
  9. value: 'batch_test_string_value'
  10. }
  11. }
  12. entries.push(entry);
  13. }
  14. kvStore.putBatch(entries).then(async () => {
  15. console.info('Succeeded in putting batch');
  16. }).catch((err) => {
  17. console.error(`Failed to put batch.code is ${err.code},message is ${err.message}`);
  18. });
  19. var query = new distributedKVStore.Query();
  20. query.prefixKey("batch_test");
  21. kvStore.getResultSize('localDeviceId', query).then((resultSize) => {
  22. console.info('Succeeded in getting resultSize');
  23. }).catch((err) => {
  24. console.error(`Failed to get resultSize.code is ${err.code},message is ${err.message}`);
  25. });
  26. } catch (e) {
  27. console.error(`Failed to get resultSize.code is ${e.code},message is ${e.message}`);
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号