输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
RelativeContainer
CustomDialogController
animateTo
CTRL+K
文档管理中心

HarmonyOS

输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
RelativeContainer
CustomDialogController
animateTo
CTRL+K
指南
指南应用服务Cloud Foundation Kit（云开发服务）云数据库初始化数据库访问

初始化数据库访问

更新时间: 2026-06-12 06:54
本文导读

约束与限制

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

前提条件

已引入对象类型文件。

操作步骤

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

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

    收起
    自动换行
    深色代码主题
    复制
    1. "requestPermissions": [
    2.   {
    3.     "name": "ohos.permission.INTERNET"
    4.   }
    5. ]

  2. （可选）如果存在需要登录应用才能操作数据库的场景（如新增或删除数据），您需要执行如下操作：

    1. 通过AuthProvider获取用户凭据。
    2. 调用init()方法进行初始化时，传入获取的凭据。

  3. 在业务代码中，使用AGC开发平台上创建的存储区“QuickStartDemo”类初始化DatabaseZone。

    收起
    自动换行
    深色代码主题
    复制
    1. import { cloudDatabase } from '@kit.CloudFoundationKit';
    2. 

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

    • cloudDatabase.zone方法接收的入参为“存储区名称”，即cloudDBZoneName，请参见新增存储区章节。

    • 存储区最多创建4个，超过4个会导致云数据库访问失败。

  4. 如果需要使用数据库查询方法，可以使用类（此处以BookInfo为例）初始化DatabaseQuery。

    收起
    自动换行
    深色代码主题
    复制
    1. import { BookInfo } from 'xx/BookInfo'; // xx是BookInfo文件的相对路径
    2. 

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

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

引入对象类型文件
查询数据
相关推荐
文档设置云存储配置项
文档初始化存储实例
文档初始化全局应用上下文
文档cloudDatabase (云数据库模块)
文档部署云数据库
文档新增对象类型
文档开通云数据库服务
文档在端侧访问云数据库
文档查询数据
文档引入对象类型文件
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 指南 中进行搜索
请输入您想要搜索的关键词