## 约束与限制

支持Phone、Tablet设备。并且从5.1.0(18)版本开始，新增支持Wearable设备；从5.1.1(19)版本开始，新增支持TV设备。

## 前提条件

已[引入对象类型文件](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/cloudfoundation-database-add-file)。

## 操作步骤

1. 设置云数据库配置项。

   在“entry/src/main/module.json5”文件中添加网络权限。

   收起

   自动换行

   深色代码主题

   复制

   ```
   1. "requestPermissions": [
   2. {
   3. "name": "ohos.permission.INTERNET"
   4. }
   5. ]
   ```
2. （可选）如果存在需要登录应用才能操作数据库的场景（如新增或删除数据），您需要执行如下操作：
   1. [通过AuthProvider获取用户凭据](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/cloudfoundation-cloudcommon#section136610231214)。
   2. 调用[cloudCommon.init()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/cloudfoundation-cloudcommon#section15555111210233)方法进行初始化时，传入获取的凭据。
3. 在业务代码中，使用AGC开发平台上创建的存储区“QuickStartDemo”类初始化DatabaseZone。

   收起

   自动换行

   深色代码主题

   复制

   ```
   1. import { cloudDatabase } from '@kit.CloudFoundationKit';

   3. let databaseZone = cloudDatabase.zone('QuickStartDemo');
   ```

   注意

   * cloudDatabase.zone方法接收的入参为“存储区名称”，即cloudDBZoneName，请参见[新增存储区](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/cloudfoundation-database-add-zone)章节。
   * 存储区最多创建4个，超过4个会导致云数据库访问失败。
4. 如果需要使用数据库查询方法，可以使用类（此处以BookInfo为例）初始化DatabaseQuery。

   收起

   自动换行

   深色代码主题

   复制

   ```
   1. import { BookInfo } from 'xx/BookInfo'; // xx是BookInfo文件的相对路径

   3. let condition = new cloudDatabase.DatabaseQuery(BookInfo);
   ```

   说明

   后续“databaseZone”、“condition”都需要在每个查询中独立使用，可以参考此章节创建，下文代码中不再重复创建的操作。