跳到主要内容

数据导入/导出

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

进入对应 数据模型 页面,选择对应数据模型,点击「导入/导出」按钮即可,导入导出格式均为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 对象
字段命名首尾不能是 . ,不能包含连续的 ...namename.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 格式需要使用点表示法访问嵌套字段