一、概述
云数据库是一款基于对象模型的数据库，采用存储区、对象类型和对象三级结构。
1. 数据模型
- 存储区
存储区是一个独立的数据存储区域，多个数据存储区之间相互独立，每个存储区拥有完全相同的对象类型定义 --类似于关系型数据库中的database
- 对象类型
用户定义存储对象的集合，不同的对象类型对应不同的数据结构 --类似于关系型数据库中的表
- 对象
对象是云数据库的基本操作单元，每一个对象，都是一条完整的数据记录。 --类似于关系型数据库中的一条记录
2. 角色和权限
角色 World所有人 Authenticated 已认证 Creator 创建者 Administrator管理者 权限：Read（查询）、upsert（增和改）、Delete（删）
二、初始化云数据库-AGC网站版本
1. 创建存储区
步骤一：开发AGC网站，进入到我的项目中，左侧菜单选择数据库
步骤二：选择存储区》新增》输入存储区名称，点击确定后，等待进度条加载完毕
2. 创建对象类型
步骤一：切换到数据类型并点击新增
步骤二：输入对象类型名后，点击下一步
步骤三：输入需要的字段，设置主键后，点击下一步
步骤四：添加索引并设置升序后，点击下一步
步骤五：设置数据权限（根据需要自行设置）>默认 》点击确定
3. 创建对象数据
切换到数据并点击新增
步骤二：选择t_test对象类型，添加数据后，点击确定
步骤三（查询数据）：页面选择存储区名称和对象类型后，点击查询
三、初始化云数据-本地项目版本
TODO：存储区直接使用之前创建的test
1. 项目结构说明
对象类型存储在objecttype目录中 对象存储在datntry目录中
2. 创建t_content对象类型
选中objecttype目录后右键>>new >> Cloud DB Object Type
输入t_content
{ "objectTypeName": "t_content", "fields": [ {"fieldName": "id", "fieldType": "IntAutoIncrement", "notNull": true, "belongPrimaryKey": true}, {"fieldName": "title", "fieldType": "String"} ], "indexes": [ {"indexName": "id", "indexList": [{"fieldName":"id","sortType":"ASC"}]} ], "permissions": [ {"role": "World", "rights": ["Read"]}, {"role": "Authenticated", "rights": ["Read", "Upsert"]}, {"role": "Creator", "rights": ["Read", "Upsert", "Delete"]}, {"role": "Administrator", "rights": ["Read", "Upsert", "Delete"]} ] }
3. 创建t_content对象
选中dataentry目录右键>new > cloud DB Data Entry
选择t_content
{ "cloudDBZoneName": "test", "objectTypeName": "t_content", "objects": [ { "id": 1, "title": "测试1" }, { "id": 2, "title": "测试2" } ] }
4. 更新
选中clouddb右键》Deploy Cloud DB
四、端侧调用云数据库
1. 前提
TOOD：因为云数据库不支持使用Long类型，所以自行添加依赖
// 添加依赖 "dependencies": { "@hw-agconnect/cloud": "^1.0.0", "@hw-agconnect/hmcore": "^1.0.0", "@hw-agconnect/auth-component": "^1.0.0", "long": "5.2.1" }
// 初始化SDK import {initialize} from "@hw-agconnect/hmcore" import jsonStr from "../../resources/rawfile/agconnect-services.json" async onCreate(){ // 初始化 try { initialize(this.context,jsonStr) }catch (e){ console.error(JSON.stringify(e)) } }
2. 建立模型
TODO: 类似：数据表实体类
将生成的js文件放入到项目中
3. 导出schema
TODO：导出选择JSON格式后，放入到项目中
4. 初始化database并查询数据
import { Database } from '@hw-agconnect/cloud/src/main/ets/database/Database'; import cloud from '@hw-agconnect/cloud'; import info from "../../resources/rawfile/cloudFunction_2_cn.json" import { t_test } from '../model/t_test'; @Entry @Component struct DataBasePage { @State message: string = 'Hello World'; private database:Database |null= null // 接收数据集 @State testList :t_test[] = [] async aboutToAppear(): Promise<void> { // 初始化 this.database= cloud.database({ zoneName:'test', objectTypeInfo:info }) this.testList = await this.database.collection(t_test).query().get() } build() { Column(){ ForEach(this.testList,(test:t_test)=>{ Row(){ Text(`${test.getId()}`) Text(test.getName()) } }) }.width("100%").height("100%") } }
