数据导入/导出
🗄️ 数据模型快速导入导出
进入对应 数据模型 页面,选择对应数据模型,点击「导入/导出」按钮即可,导入导出格式均为Excel格式(.xlsx)
若您想导出JSON/CSV格式的数据,请参考下面的通过 「集合管理」 进行导入导出章节
📥 集合管理导入
CloudBase 支持批量导入数据,帮助您快速迁移现有数据或初始化测试数据。
🚀 操作流程
- 访问控制台:进入 CloudBase 控制台
- 选择集合:切换到 集合管理页面,选择目标集合
- 开始导入:点击"导入"按钮(支持 JSON 和 CSV 格式)
- 配置导入:选择文件格式和冲突处理模式
- 执行导入:点击"导入"开始数据导入过程
⚙️ 冲突处理模式
模式 | 行为 | 适用场景 | 注意事项 |
---|---|---|---|
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 支持将集合数据导出为文件,便于数据备份、分析或迁移到其他系统。
🚀 操作流程
- 访问控制台:进入 CloudBase 控制台
- 选择集合:切换到 集合管理页面,选择要导出的集合
- 开始导出:点击"导出"按钮
- 配置导出:选择导出格式、保存位置和字段范围
- 执行导出:点击"导出"开始数据导出过程
📋 导出格式配置
JSON 格式导出
特点:
- 保留完整的数据结构
- 支持嵌套对象和数组
- 默认导出所有字段
字段配置:
- 不指定字段:导出所有数据(推荐)
- 指定字段:只导出指定的字段
CSV 格式导出
特点:
- 适合表格数据分析
- 兼容 Excel 等工具
- 必须指定导出字段
字段配置示例:
// 基础字段导出
_id, name, age, email
// 包含系统字段
_id, name, age, createdAt, updatedAt
📊 导出选项对比
格式 | 字段要求 | 数据完整性 | 适用场景 |
---|---|---|---|
JSON | 可选 | 完整保留 | 数据备份、系统迁移 |
CSV | 必填 | 扁平化处理 | 数据分析、Excel 处理 |
💡 最佳实践
- 数据备份:使用 JSON 格式,不指定字段,导出完整数据
- 数据分析:使用 CSV 格式,指定需要分析的字段
- 大数据集:分批导出,避免单次导出数据量过大
- 嵌套数据:CSV 格式需要使用点表示法访问嵌套字段