数据导入/导出

🗄️ 数据模型快速导入导出

进入对应 数据模型 页面，选择对应数据模型，点击「导入/导出」按钮即可，导入导出格式均为Excel格式（.xlsx）

若您想导出JSON/CSV格式的数据，请参考下面的通过 「集合管理」 进行导入导出章节

📥 集合管理导入

CloudBase 支持批量导入数据，帮助您快速迁移现有数据或初始化测试数据。

🚀 操作流程

1. 访问控制台：进入 CloudBase 控制台
2. 选择集合：切换到 集合管理页面，选择目标集合
3. 开始导入：点击"导入"按钮（支持 JSON 和 CSV 格式）
4. 配置导入：选择文件格式和冲突处理模式
5. 执行导入：点击"导入"开始数据导入过程

⚙️ 冲突处理模式

模式	行为	适用场景	注意事项
Insert	总是插入新记录	全新数据导入	不能有重复的 _id
Upsert	存在则更新，不存在则插入	数据更新、增量导入	基于 _id 判断是否存在

💡 选择建议

• 首次导入：推荐使用 Insert 模式，确保数据完整性
• 数据更新：推荐使用 Upsert 模式，避免重复数据

📄 支持的文件格式

JSON 格式

编码要求：UTF-8 编码 格式特点：类似 JSON Lines 格式，每行一个 JSON 对象

{"_id": "user_001", "name": "张三", "age": 25, "email": "zhang@example.com"}
{"_id": "user_002", "name": "李四", "age": 30, "email": "li@example.com"}
{"_id": "user_003", "name": "王五", "age": 28, "email": "wang@example.com"}

CSV 格式

编码要求：UTF-8 编码 格式特点：第一行为字段名，后续行为数据

_id,name,age,email
user_001,张三,25,zhang@example.com
user_002,李四,30,li@example.com
user_003,王五,28,wang@example.com

⚠️ 格式要求与限制

JSON 格式规范

规范项	要求	示例
分隔符	使用换行符 \n 分隔记录	每行一个 JSON 对象
字段命名	首尾不能是 . ，不能包含连续的 ..	❌ .name 、 name. 、 a..b
键名唯一	不能有重复或歧义的键名	❌ {"a": 1, "a": 2}
时间格式	使用 ISODate 格式	{"date": {"$date": "2024-01-15T10:30:00.882Z"}}

数据完整性要求

模式	要求	说明
Insert 模式	_id 不能重复	文件内部和数据库中都不能有相同的 _id
Upsert 模式	允许 _id 重复	相同 _id 的记录会被更新

📊 导入结果

导入完成后，系统会显示详细的导入统计信息：

• ✅ 成功导入的记录数
• ❌ 失败的记录数及原因
• ⚠️ 跳过的记录数（如重复数据）

📤 集合管理导出

CloudBase 支持将集合数据导出为文件，便于数据备份、分析或迁移到其他系统。

🚀 操作流程

1. 访问控制台：进入 CloudBase 控制台
2. 选择集合：切换到 集合管理页面，选择要导出的集合
3. 开始导出：点击"导出"按钮
4. 配置导出：选择导出格式、保存位置和字段范围
5. 执行导出：点击"导出"开始数据导出过程

📋 导出格式配置

JSON 格式导出

特点：

• 保留完整的数据结构
• 支持嵌套对象和数组
• 默认导出所有字段

字段配置：

• 不指定字段：导出所有数据（推荐）
• 指定字段：只导出指定的字段

CSV 格式导出

特点：

• 适合表格数据分析
• 兼容 Excel 等工具
• 必须指定导出字段

字段配置示例：

// 基础字段导出
_id, name, age, email

// 包含系统字段
_id, name, age, createdAt, updatedAt

📊 导出选项对比

格式	字段要求	数据完整性	适用场景
JSON	可选	完整保留	数据备份、系统迁移
CSV	必填	扁平化处理	数据分析、Excel 处理

💡 最佳实践

• 数据备份：使用 JSON 格式，不指定字段，导出完整数据
• 数据分析：使用 CSV 格式，指定需要分析的字段
• 大数据集：分批导出，避免单次导出数据量过大
• 嵌套数据：CSV 格式需要使用点表示法访问嵌套字段

---