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