js-apis-data-valuesBucket.md

# @ohos.data.ValuesBucket (数据集)

**数据集(ValuesBucket)** 是开发者向数据库插入的数据集合，数据集以键-值对的形式进行传输。

> **说明：**
>
> 本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。


## 导入模块

```ts
import { ValueType } from '@ohos.data.ValuesBucket';
import { ValuesBucket } from '@ohos.data.ValuesBucket';
```

## ValueType

该类型用于表示数据库允许的数据字段类型。

**系统能力：**  SystemCapability.DistributedDataManager.DataShare.Core

| 类型    | 说明                 |
| ------- | -------------------- |
| number  | 表示字段类型为数字。   |
| string  | 表示字段类型为字符串。 |
| boolean | 表示字段类型为布尔值。 |

## ValuesBucket

用于存储键值对的类型。该类型不是多线程安全的，如果应用中存在多线程同时操作该类派生出的实例，注意加锁保护。 

**系统能力：**  SystemCapability.DistributedDataManager.DataShare.Core

| 键类型          | 值类型                                      |
| ------------- | --------------------------------------------- |
|  string | [ValueType](#valuetype)\| Uint8Array \| null |