如何把json文件导入到mogon

手把手教你：将JSON文件轻松导入MongoDB数据库

在现代数据驱动的开发中，JSON（JavaScript Object Notation）因其轻量级、易读和灵活的特性，已成为数据交换的事实标准，MongoDB作为一款流行的NoSQL数据库，其原生存储格式正是BSON（Binary JSON），与JSON高度兼容，将JSON文件数据导入MongoDB是一个非常常见的需求，本文将为你详细介绍几种主流且高效的方法,助你轻松完成数据导入任务。

在开始之前，请确保你已经安装并运行了MongoDB服务，并且熟悉mongod和mongo（或mongosh）这两个基本命令行工具。

使用 mongoimport 命令行工具（最常用、最直接）

mongoimport是MongoDB官方提供的强大命令行工具，专门用于将JSON、CSV或TSV格式的数据导入到MongoDB集合中,这是处理单个JSON文件最推荐的方法。

基本语法

mongoimport命令的基本结构如下：

mongoimport --collection <集合名> --db <数据库名> --file <JSON文件路径> [选项]

参数详解

• --collection, -c: 指定要导入数据的目标集合名称，如果集合不存在，mongoimport会自动创建。
• --db, -d: 指定要导入数据的目标数据库名称，如果数据库不存在,也会自动创建。
• --file, -f: 指定要导入的JSON文件的完整路径或相对路径。
• --drop (可选): 在导入前删除目标集合中已存在的所有数据，这是一个非常实用的选项，可以确保导入是“干净”的，但使用时需谨慎,因为它会永久删除数据。
• --jsonArray (可选): 如果你的JSON文件顶层是一个数组（即多个JSON对象被包裹在 [] 中），必须使用此选项,这是最常见的情况。
• --mode (可选): 指定导入模式。
  • insert (默认): 只插入新文档，遇到重复的 _id 会报错并停止。
  • upsert: 如果文档的 _id 已存在，则更新该文档；如果不存在,则插入新文档。
  • merge: 将新文档与现有文档合并。
  • replace: 用新文档完全替换现有文档。
• --headerline (可选): 仅用于CSV或TSV文件，表示第一行是列名,对JSON文件无效。

实战演练

假设我们有一个名为 users.json 的文件,内容如下：

users.json

[
  { "_id": 1, "name": "Alice", "email": "alice@example.com", "age": 30 },
  { "_id": 2, "name": "Bob", "email": "bob@example.com", "age": 25 },
  { "_id": 3, "name": "Charlie", "email": "charlie@example.com", "age": 35 }
]

目标： 将此数据导入到 myApp 数据库的 users 集合中。

步骤：

1. 打开你的终端或命令提示符。

2. 执行以下命令：

   mongoimport --collection users --db myApp --file ./users.json --jsonArray --drop

3. 命令解析：

   • --collection users: 目标集合是 users。
   • --db myApp: 目标数据库是 myApp。
   • --file ./users.json: 导入当前目录下的 users.json 文件。
   • --jsonArray: 告诉工具 users.json 的顶层是一个JSON数组。
   • --drop: 导入前清空 myApp.users 集合中的旧数据。

4. 验证结果： 连接到MongoDB,并查询数据以确认导入成功。

   # 连接到MongoDB shell
   mongo
   # 切换到目标数据库
   use myApp
   # 查询所有文档
   db.users.find()

   你应该能看到 users 集合中包含了 users.json 文件中的三条记录。

使用 mongosh (MongoDB Shell) 执行JavaScript脚本

对于更复杂的导入逻辑，或者当你的JSON数据是动态生成时，可以使用 mongosh 执行JavaScript代码来导入数据,这种方法提供了更大的灵活性。

准备工作

你需要将JSON文件的内容读入到一个JavaScript变量中，如果文件很大，直接在mongosh中读取可能会遇到内存限制,因此此方法更适合中小型文件。

假设 users.json 文件内容同上。

实战演练

1. 读取JSON文件内容： 你可以在操作系统层面读取文件内容，然后将其复制粘贴到 mongosh 中。

   # 在终端中查看文件内容
   cat users.json

2. 执行导入脚本： 打开 mongosh,执行以下操作：

   // 1. 连接到你的MongoDB实例（如果mongosh启动时未指定）
   // 2. 选择或创建目标数据库
   use myApp;
   // 3. 将文件内容粘贴到一个变量中
   // 这里为了演示，我们直接在JS中定义数组
   const jsonData = [
     { "_id": 1, "name": "Alice", "email": "alice@example.com", "age": 30 },
     { "_id": 2, "name": "Bob", "email": "bob@example.com", "age": 25 },
     { "_id": 3, "name": "Charlie", "email": "charlie@example.com", "age": 35 }
   ];
   // 4. 使用 insertMany() 方法将数据插入集合
   // db.collection.insertMany() 会接受一个文档数组并高效地插入
   db.users.insertMany(jsonData);
   // 你会看到类似 "insertedIds: [ 1, 2, 3 ]" 的成功反馈

优缺点

• 优点：
  • 灵活性极高，可以在导入前对数据进行清洗、转换或验证。
  • 不依赖外部命令行工具,完全在数据库内部操作。
• 缺点：
  • 对于大文件，内存消耗大，容易导致mongosh崩溃。
  • 操作步骤比mongoimport繁琐，不适合简单的、一次性的导入任务。

使用编程语言（如Node.js）进行导入

如果你正在开发一个应用程序，并且需要在应用逻辑中实现数据导入，那么使用编程语言（如Node.js，因为其与JSON和MongoDB原生集成）是最佳选择。

准备工作

确保你已经安装了Node.js和MongoDB的Node.js驱动。

npm install mongodb

实战演练

创建一个名为 import.js 的文件：

import.js

const { MongoClient } = require('mongodb');
const fs = require('fs');
// --- 配置 ---
const uri = "mongodb://localhost:27017"; // MongoDB连接字符串
const dbName = "myApp";
const collectionName = "users";
const jsonFilePath = "./users.json";
// --- 主函数 ---
async function main() {
  const client = new MongoClient(uri);
  try {
    // 1. 连接到MongoDB集群
    await client.connect();
    console.log("成功连接到MongoDB!");
    // 2. 获取数据库和集合
    const database = client.db(dbName);
    const collection = database.collection(collectionName);
    // 3. 读取JSON文件
    const jsonData = JSON.parse(fs.readFileSync(jsonFilePath, 'utf8'));
    // 4. 插入数据
    const result = await collection.insertMany(jsonData);
    console.log(`${result.insertedCount} 个文档已成功插入到 ${dbName}.${collectionName} 集合中，`);
  } catch (e) {
    console.error("发生错误:", e);
  } finally {
    // 5. 确保关闭连接
    await client.close();
    console.log("MongoDB连接已关闭。");
  }
}
main().catch(console.error);

运行脚本：

node import.js

总结与对比