数据模型概述

什么是数据模型？

数据模型是云开发提供的声明式数据管理解决方案，它构建在云开发数据库之上，为开发者提供了一种更高效、更安全的数据操作方式。

简单来说，数据模型就像是为您的数据定制的"智能管家"：

📋 定义数据结构：通过可视化界面定义数据的字段、类型和关系
🛡️ 自动数据校验：确保数据的准确性和一致性
🔗 处理关联关系：自动管理数据之间的复杂关系
🚀 包含多端 SDK：一次定义，多端使用（小程序、Web、云函数）
🎛️ 内置管理界面：提供开箱即用的数据管理后台
🤖 AI 智能分析：利用人工智能挖掘数据价值

💡 核心理念：让开发者专注于业务逻辑，而不是底层数据操作的复杂性。

核心特性一览

特性	描述	价值
🔍 智能数据校验	自动检查数据类型和格式，防止错误数据入库	提高数据质量，减少 Bug
🔗 关联关系管理	自动处理一对一、一对多、多对多关系	简化复杂查询，提升开发效率
⚡ 包含多端 SDK	一次定义，自动生成小程序/Web/云函数 SDK	统一开发体验，减少重复工作
🎛️ 可视化管理	内置 CMS 管理界面，支持非技术人员操作	降低运营成本，提升协作效率
🏗️ 低代码应用生成	一键生成可定制的管理后台应用	快速交付，缩短开发周期
🤖 AI 数据分析	智能分析数据趋势和模式	数据驱动决策，挖掘业务价值
🚀 高级查询能力	支持复杂条件查询、聚合分析等	满足多样化业务需求

数据模型架构图

数据模型和数据库的关系

数据模型是对数据库的抽象，它定义了数据模型的结构、字段、约束和关系。数据模型提供了一种统一的方式来描述和操作数据，简化了数据操作和查询。数据模型能力即为开发中常用的对象关系映射 ORM。

数据模型和数据库是关联关系，一个数据模型，对应了数据库中的一个集合（非结构化数据库）或表（结构化数据库）。

使用数据模型，不代表被限制为仅能使用数据模型。在使用数据模型的同时，如果需要有更复杂、或数据模型无法很好完成的操作，也可以通过数据库的原生方法，直接操作数据库完成数据读写。

相对于传统开发框架中的 ORM，云开发数据模型除 ORM 相关的 SDK 操作数据的能力外，额外整合了数据管理界面、用户及权限体系、内容管理以及进一步的基于数据模型的应用生成、数据分析等更多能力。更多优势点可以查看 “为什么要使用数据模型”。

如何开始使用数据模型？

🚀 快速开始

访问控制台：进入 CloudBase 控制台
选择数据库：切换到数据库/文档型
创建模型：点击【新建模型】，选择创建方式

📋 创建方式

方式	适用场景	说明
🆕 添加模型	新项目开发	从零开始创建全新的数据模型
📦 导入旧版 CMS	项目迁移	从现有的云开发 CMS 导入模型，享受新版本的功能升级

创建数据模型

✅ 创建完成

新建模型后，您就可以立即使用数据模型提供的各项强大能力了！

💡 提示：建议先阅读快速开始教程，通过实际案例快速上手。

为什么选择数据模型？

数据模型为开发者带来了全方位的开发体验提升：

🚀 提高开发效率：自动生成 SDK，减少重复代码编写
💰 降低维护成本：统一的数据管理，减少运维工作量
🛡️ 增强数据安全：内置权限控制和数据校验机制
📊 强化数据分析：AI 智能分析，挖掘数据价值
🎯 简化团队协作：可视化管理界面，技术与非技术人员都能轻松使用

🛡️ 智能数据校验和类型检查

数据模型提供自动化的数据校验机制，在数据入库前进行严格的类型检查和格式验证，确保数据的准确性和一致性，从源头避免数据质量问题。

📝 实际案例演示

假设我们定义了一个文章模型 post，包含以下字段：

title（字符串类型）- 文章标题
body（字符串类型）- 文章内容

现在我们故意传入错误类型的数据来测试校验机制：

try {
  const { data } = await models.post.create({
    data: {
      title: "你好，世界👋",
      body: 123456, // ❌ 故意传入数字类型，期望的是字符串类型
    },
  });

  console.log("创建成功:", data);
} catch (error) {
  console.error("校验失败:", error);
}

🚨 校验结果

当我们尝试插入类型错误的数据时，数据模型会立即检测到问题并阻止操作：

Error: WxCloudSDKError: 【错误】数据格式校验失败。根因：[#/body: expected type: String, found: Integer]，原因：字段[正文], 标识[body], 类型不匹配:期望类型:字符串。，解决步骤：请按照原因修改数据类型。 errRecord:{"title":"你好，世界👋","body":123456}【操作】调用 post.create

✅ 校验优势

🔍 精确定位：准确指出哪个字段出现了什么问题
📝 友好提示：提供清晰的错误原因和解决建议
🛡️ 数据保护：防止脏数据进入数据库
🐛 减少 Bug：在开发阶段就发现数据类型问题

🔗 智能关联关系处理

数据模型能够自动处理复杂的数据关联关系，支持一对一、一对多、多对多等各种关系类型。无需手动编写复杂的 JOIN 查询，系统会自动处理数据之间的关联逻辑。

🎯 关联查询示例

以文章和评论的关联关系为例，我们可以轻松实现跨模型的数据查询。通过 select 参数，可以精确控制返回的字段和关联数据：

const { data } = await models.post.list({
  // 精确控制返回字段，优化查询性能
  select: {
    _id: true,
    title: true,
    updatedAt: true,
    // 关联查询评论数据
    comments: {
      _id: true,
      createdAt: true,
      comment: true,
    },
  },
  filter: {
    where: {}, // 查询条件
  },
  getCount: true, // 获取总数
});

console.log("查询结果:", data);

📊 返回结果

系统会自动处理关联关系，返回结构化的数据：

{
  "records": [
    {
      "_id": "9FSAHWM9VV",
      "title": "Bonjour le Monde👋",
      "updatedAt": 1718096503886,
      "comments": [
        {
          "_id": "9FSAJF3GLG",
          "createdAt": 1718096509916,
          "comment": "这是一条评论"
        }
      ]
    },
    {
      "_id": "9FSAHWM9VU",
      "title": "你好，世界👋",
      "updatedAt": 1718096503886,
      "comments": [] // 暂无评论
    }
  ],
  "total": 2
}

✨ 关联查询优势

🚀 性能优化：只返回需要的字段，减少数据传输
🔄 自动关联：无需手写复杂的 JOIN 语句
📱 多层嵌套：支持深层次的关联数据查询
🎯 精确控制：灵活指定每个关联对象的返回字段

⚡ 多端 SDK 自动生成

云开发平台提供了多端对接的 SDK，支持小程序、Web、云函数等多个平台。一次定义，多端复用，大幅提升开发效率。

🔄 智能 Upsert 操作

以 upsert() 方法为例，它能智能判断是创建新记录还是更新现有记录：

const postData = {
  title: "Hello World",
  body: "这是一篇示例文章",
  _id: "hello-world-post",
};

const { data } = await models.post.upsert({
  create: postData,  // 如果不存在则创建
  update: postData,  // 如果存在则更新
  filter: {
    where: {
      _id: { $eq: postData._id }
    },
  },
});

console.log("操作结果:", data);

📊 返回结果说明

// 🆕 创建新记录时
{
  "count": 0,        // 更新的记录数为 0
  "id": "hello-world-post"  // 新创建记录的 ID
}

// 🔄 更新现有记录时
{
  "count": 1,        // 更新的记录数为 1
  "id": ""          // 更新操作不返回 ID
}

🎯 多端 SDK 优势

📱 统一接口：所有平台使用相同的 API 调用方式
🔒 类型安全：TypeScript 支持，编译时发现错误
⚡ 自动优化：根据平台特性自动优化性能
🔄 实时同步：模型变更后 SDK 自动更新

🎛️ 内置 CMS 管理系统

数据模型提供开箱即用的内容管理系统（CMS），让非技术人员也能轻松进行数据管理和维护，大幅降低运营成本。

✨ CMS 核心功能

📝 可视化编辑：直观的表单界面，无需编程知识
👥 权限管理：细粒度的用户权限控制
📊 数据统计：内置数据分析和报表功能
🔍 高级搜索：支持多条件筛选和排序
📱 响应式设计：支持桌面和移动端访问

📚 了解更多：查看 CMS 详细介绍了解完整功能

CMS 管理界面

🏗️ 低代码应用生成器

数据模型支持一键生成完整的管理后台应用，采用先进的低代码技术，支持可视化修改和定制开发，让您无需从零编写管理界面。

🎨 低代码特性

🖱️ 拖拽式设计：通过拖拽组件快速构建界面
🎯 模板丰富：提供多种预设模板和组件
🔧 深度定制：支持自定义样式和业务逻辑
📦 一键部署：生成的应用可直接部署使用
🔄 实时预览：所见即所得的开发体验

低代码应用生成器

🤖 AI 智能数据分析

数据模型集成了强大的 AI 分析引擎，能够自动挖掘数据中的模式和趋势，为业务决策提供智能化支持。

🧠 AI 分析能力

📈 趋势预测：基于历史数据预测未来趋势
🔍 异常检测：自动识别数据中的异常模式
📊 智能报表：自动生成可视化分析报告
💡 洞察建议：提供基于数据的业务建议
🎯 用户画像：智能分析用户行为特征

🚀 价值体现：从海量数据中提取有价值的商业洞察，让数据真正驱动业务增长

AI 智能分析界面

🚀 高级数据库查询支持

数据模型支持原生 SQL 查询，兼容 MySQL 等关系型数据库的高级查询功能。当模型 API 无法满足复杂查询需求时，您可以直接使用 SQL 语句进行精确控制。

💪 高级查询能力

🔍 复杂条件筛选：支持多表联查、子查询等
📊 聚合分析：GROUP BY、HAVING、聚合函数等
⚡ 性能优化：索引优化、查询计划分析
🔒 安全防护：参数化查询，防止 SQL 注入

📝 实际案例

查询作者联系电话以"1858"开头的记录：

const result = await models.$runSQL(
  "SELECT * FROM `article_table` WHERE author_tel LIKE '{{tel}}';",
  {
    tel: "1858%", // 参数化查询，安全可靠
  }
);

console.log("查询结果:", result);

📊 返回结果

{
  "data": {
    "total": 1,
    "executeResultList": [
      {
        "_id": "9JXU7BWFZJ",
        "title": "示例文章",
        "author_tel": "18588881111",
        "createdAt": 1719475245475,
        "region": "北京市"
        // ... 其他字段
      }
    ],
    "backendExecute": "28"
  },
  "requestId": "0d4c98c3-a3ff-4c55-93cc-d0f5c835f82c"
}

📚 深入学习：查看数据库原生查询文档了解更多高级用法

🎯 总结

云开发数据模型为现代应用开发提供了全方位的数据管理解决方案：

🏗️ 架构优势：基于云原生架构，稳定可靠
🚀 开发效率：自动生成 SDK，减少重复工作
🛡️ 数据安全：内置校验和权限控制机制
🎛️ 管理便捷：可视化管理界面，降低运营成本
🤖 智能分析：AI 驱动的数据洞察能力
🔧 灵活扩展：支持原生查询和自定义逻辑

立即开始您的数据模型之旅！ 👉 快速开始教程

数据模型概述

什么是数据模型？​

核心特性一览​

数据模型和数据库的关系​

如何开始使用数据模型？​

🚀 快速开始​

📋 创建方式​

✅ 创建完成​

为什么选择数据模型？​

🛡️ 智能数据校验和类型检查​

📝 实际案例演示​

🚨 校验结果​

✅ 校验优势​

🔗 智能关联关系处理​

🎯 关联查询示例​

📊 返回结果​

✨ 关联查询优势​

⚡ 多端 SDK 自动生成​

🔄 智能 Upsert 操作​

📊 返回结果说明​

🎯 多端 SDK 优势​

🎛️ 内置 CMS 管理系统​

✨ CMS 核心功能​

🏗️ 低代码应用生成器​

🎨 低代码特性​

🤖 AI 智能数据分析​

🧠 AI 分析能力​

🚀 高级数据库查询支持​

💪 高级查询能力​

📝 实际案例​

📊 返回结果​

🎯 总结​

什么是数据模型？

核心特性一览

数据模型和数据库的关系

如何开始使用数据模型？

🚀 快速开始

📋 创建方式

✅ 创建完成

为什么选择数据模型？

🛡️ 智能数据校验和类型检查

📝 实际案例演示

🚨 校验结果

✅ 校验优势

🔗 智能关联关系处理

🎯 关联查询示例

📊 返回结果

✨ 关联查询优势

⚡ 多端 SDK 自动生成

🔄 智能 Upsert 操作

📊 返回结果说明

🎯 多端 SDK 优势

🎛️ 内置 CMS 管理系统

✨ CMS 核心功能

🏗️ 低代码应用生成器

🎨 低代码特性

🤖 AI 智能数据分析

🧠 AI 分析能力

🚀 高级数据库查询支持

💪 高级查询能力

📝 实际案例

📊 返回结果

🎯 总结