初始化数据库访问
========

#### 约束与限制

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

#### 前提条件

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

#### 操作步骤

1.  设置云数据库配置项。
    
    在“entry/src/main/module.json5”文件中添加网络权限。
    
    "requestPermissions": \[
      {
        "name": "ohos.permission.INTERNET"
      }
    \]
    
2.  （可选）如果存在需要登录应用才能操作数据库的场景（如新增或删除数据），您需要执行如下操作：
    
    1.  [通过AuthProvider获取用户凭据](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/cloudfoundation-cloudcommon#authprovider)。
    2.  调用[init()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/cloudfoundation-cloudcommon#init)方法进行初始化时，传入获取的凭据。
3.  在业务代码中，使用AGC开发平台上创建的存储区“QuickStartDemo”类初始化DatabaseZone。
    
    import { cloudDatabase } from '@kit.CloudFoundationKit';
    
    let databaseZone = cloudDatabase.zone('QuickStartDemo');
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e0/v3/_XR1vyitTe-gYe7dItfJjQ/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073603Z&HW-CC-Expire=86400&HW-CC-Sign=1B3D331479D2B033F4FF1F605661BEDA16B4C5ADC7BB89C1563FFD00655A8055)
    
    *   cloudDatabase.zone方法接收的入参为“存储区名称”，即cloudDBZoneName，请参见[新增存储区](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/cloudfoundation-database-add-zone)章节。
        
    *   存储区最多创建4个，超过4个会导致云数据库访问失败。
        
    
4.  如果需要使用数据库查询方法，可以使用类（此处以BookInfo为例）初始化DatabaseQuery。
    
    import { BookInfo } from 'xx/BookInfo'; // xx是BookInfo文件的相对路径
    
    let condition = new cloudDatabase.DatabaseQuery(BookInfo);
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/2d/v3/m1DT3_HrSqW5g0XiGJUZ2w/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073603Z&HW-CC-Expire=86400&HW-CC-Sign=CE67211AE1F30D6A4B486E5BC9BBC9083CBED31ADDB954F9BFD950266EEF3283)
    
    后续“databaseZone”、“condition”都需要在每个查询中独立使用，可以参考此章节创建，下文代码中不再重复创建的操作。