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