1# @ohos.data.ValuesBucket (数据集) 2<!--Kit: ArkData--> 3<!--Subsystem: DistributedDataManager--> 4<!--Owner: @woodenarow--> 5<!--Designer: @woodenarow; @xuelei3--> 6<!--Tester: @chenwan188; @logic42--> 7<!--Adviser: @ge-yafang--> 8 9**数据集(ValuesBucket)** 是开发者向数据库插入的数据集合,数据集以键值对的形式进行传输。 10 11> **说明:** 12> 13> 本模块首批接口从API version 10开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 14> 15> 本模块接口仅可在Stage模型下使用。 16 17 18## 导入模块 19 20```ts 21import { ValueType, ValuesBucket } from '@kit.ArkData'; 22``` 23 24## ValueType 25 26type ValueType = number | string | boolean 27 28该类型用于表示数据库允许的数据字段类型。 29 30**系统能力:** SystemCapability.DistributedDataManager.DataShare.Core 31 32**原子化服务API:** 从API version 20开始,该接口支持在原子化服务中使用。 33 34| 类型 | 说明 | 35| ------- | -------------------- | 36| number | 表示字段类型为数字。 | 37| string | 表示字段类型为字符串。 | 38| boolean | 表示字段类型为布尔值。 | 39 40## ValuesBucket 41 42type ValuesBucket = Record<string, ValueType | Uint8Array | null> 43 44用于存储键值对的类型。该类型不是多线程安全的,如果应用中存在多线程同时操作该类派生出的实例,注意加锁保护。 45 46**系统能力:** SystemCapability.DistributedDataManager.DataShare.Core 47 48| 类型 | 说明 | 49| ------------- | --------------------------------------------- | 50| Record<string, [ValueType](#valuetype) \| Uint8Array \| null> | 表示键值对类型。键的类型为string,值的类型为[ValueType](#valuetype) \| Uint8Array \| null。| 51