概述
文档型数据库是 CloudBase 提供的数据库服务，支持灵活的 JSON 文档存储，包含集合管理和数据模型两个核心功能。
集合管理
集合管理是 CloudBase 提供的基础数据存储服务，基于文档型数据库，为开发者提供灵活的 JSON 文档存储能力。
核心特点
| 特点 | 说明 | 适用场景 |
|---|---|---|
| JSON 文档存储 | 支持任意结构的 JSON 数据 | 灵活的数据结构需求 |
| 快速上手 | 无需预定义数据结构 | 快速原型开发 |
| 事务支持 | 支持多文档事务操作 | 数据一致性要求 |
| 原生操作 | 直接进行 CRUD 操作 | 简单数据管理 |
创建方式
方式1：小程序 IDE 端
方式2：云开发平台
数据模型
文档型数据模型是基于集合的上层建模，提供可视化定义、自动校验、关联管理、内置 CMS 等能力，帮助开发者快速构建业务数据库。
具体数据模型功能请参考 数据模型。
核心特点
| 能力 | 说明 | 价值 |
|---|---|---|
| 可视化定义 | 通过界面定义数据结构、字段类型和关系 | 降低开发门槛，提升效率 |
| 自动校验 | 确保数据准确性，防止错误数据入库 | 保证数据质量，减少 Bug |
| 关联管理 | 自动处理数据间的复杂关系 | 简化复杂业务逻辑 |
| 内置 CMS | 开箱即用的数据管理后台 | 非技术人员也能管理数据 |
| AI 分析 | 智能挖掘数据价值 | 数据驱动决策 |
| 系统字段 | 自动管理数据标识、时间戳、用户信息等 | 减少样板代码，专注业务 |
智能系统字段管理
操作数据模型时，系统会自动添加以下系统字段，并在数据操作时自动维护：
| 系统字段 | 描述 | 自动更新时机 |
|---|---|---|
_id | 数据唯一标识符 | 创建时自动生成 |
createdAt | 创建时间戳 | 创建时自动生成 |
updatedAt | 更新时间戳 | 每次更新时自动更新 |
_openid | 用户标识（小程序） | 用户端操作时自动生成 |
owner | 数据所有者 | 创建时自动设置 |
createBy | 创建者标识 | 创建时自动设置 |
updateBy | 最后修改者 | 每次更新时自动更新 |
💡 注意：开发者无需手动管理这些字段，系统自动处理数据的生命周期管理，让您专注于业务逻辑实现。
实际应用示例
假设创建了一个名为 users 的文档型数据模型，user123 用户通过数据模型新增如下结构数据：
{
"name": "张三",
"email": "zhangsan@example.com",
"age": 25
}
系统自动添加的完整数据：
{
"_id": "64f1a2b3c4d5e6f7g8h9i0j1",
"name": "张三",
"email": "zhangsan@example.com",
"age": 25,
"createdAt": "2024-01-15T10:30:00Z",
"updatedAt": "2024-01-15T10:30:00Z",
"_openid": "user123",
"owner": "user123",
"createBy": "user123",
"updateBy": "user123"
}
通过集合创建数据模型
由于数据模型是基于集合的上层建模，创建文档型数据模型时，会自动创建对应的集合。
但创建集合时，不会自动创建对应的数据模型。
因此可以在 云开发平台/数据模型 页面，选择「基于集合创建模型」。
