鸿蒙应用（HarmonyOS 5）集成,云数据库开发指南

一、云服务准备阶段

1. 账号注册与认证

• 注册华为云账号
  • 访问华为云官网
  • 点击"注册"填写手机号/邮箱、验证码和密码
  • 已有账号可直接登录控制台
• 实名认证
  • 个人用户：提供身份证信息
  • 企业用户：提供营业执照等信息

2. 云数据库创建（两种方法）

方法一：控制台创建

1. 进入数据库服务
   • 登录后选择"数据库" > "云数据库RDS"（或其他类型如MongoDB）
2. 创建数据库实例

1. 创建表结构

1. 添加初始数据

方法二：项目工程创建

1. 创建表结构

• 添加字段、索引（默认权限即可）

2. 添加初始数据

1. 部署到云端

二、工程配置阶段

1. 数据库模型配置

• 建立JS类型模型

• 导出Schema为JSON文件（如testyunduan.json）
• 添加到工程resources/rawfile目录

三、代码实现阶段

1. 依赖导入说明

// 必须导入的依赖项
import testyunduan from '../../resources/rawfile/testyunduan.json';
import { t_article } from '../model/t_article';
import { t_students } from '../model/t_students';

// 说明：
// testyunduan.json - 云端数据库的完整配置（表结构、权限等）
// t_students - 本地定义的数据模型类，必须与云端表结构完全匹配

2. 数据库初始化

@State studentArray: t_students[] = []; // 学生数据数组

private database: Database | null = null; // 数据库实例

async aboutToAppear() {
  // 初始化云数据库连接
  this.database = cloud.database({
    zoneName: 'test', // 存储区名称（测试环境）
    objectTypeInfo: testyunduan // 数据库schema配置
  });

  // 查询学生数据
  try {
    this.studentArray = await this.database.collection(t_students)
      .query() // 查询条件（不传参表示查询全部）
      .get(); // 执行查询
  } catch (err) {
    console.error('查询失败:', err);
  }
}

1. 关键API说明

• cloud.database()
  • 功能：初始化云端数据库连接
  • 参数：
    • zoneName：环境标识（test/dev/prod）
    • objectTypeInfo：表结构配置（来自JSON文件）
• .collection(t_students)
  • 功能：绑定数据模型到数据库集合
  • 后续可进行增删改查操作

4. 数据渲染

Column({space:10}){
  ForEach(this.studentArray, (item: t_students) => {
    Row() {
      Text(`${item.setId()}`)    // 显示学生ID
      Text(`${item.setName()}`)  // 显示学生姓名
      Text(`${item.setAge()}`)   // 显示学生年龄
    }
  })
}

更多操作参考：华为云数据库官方文档