MongoDB insertOne() 方法 – db.Collection.insertOne()

简介

insertOne() 是 MongoDB 中的一个方法，用于向指定集合中插入一条文档。该方法可以帮助程序员轻松地将数据添加到 MongoDB 数据库中。

语法

db.Collection.insertOne(document, options)

• document: 必需，要插入的文档数据。
• options: 可选，用于设置插入选项的参数。

返回值

insertOne() 方法返回一个包含插入文档的结果对象。

示例

const { MongoClient } = require('mongodb');
const uri = 'mongodb://localhost:27017/mydb';

async function insertDocument() {
  const client = new MongoClient(uri, { useUnifiedTopology: true });
  try {
    await client.connect();
    const database = client.db("mydb");
    const collection = database.collection("mycollection");
  
    const document = { name: "John", age: 28, city: "New York" };
  
    const result = await collection.insertOne(document);
    console.log(`${result.insertedCount} document(s) inserted.`);
  } finally {
    await client.close();
  }
}

insertDocument();

上述示例代码展示了如何使用 insertOne() 方法向名为 mycollection 的集合中插入一个文档。首先，使用 MongoClient 连接到 MongoDB 数据库。然后，选择要使用的数据库和集合。接下来，创建一个文档对象 document，包含要插入的数据。最后，调用 insertOne(document) 方法将文档插入到集合中，并输出插入的文档数量。

特点和注意事项

• insertOne() 只能插入一个文档。如果要插入多个文档，请使用 insertMany() 方法。
• 插入的文档必须是一个 JavaScript 对象。
• 如果插入的文档中已经存在一个 _id 字段，那么插入操作将会失败，因为 _id 字段在集合中必须是唯一的。
• 如果不提供 _id 字段，MongoDB 会自动生成一个唯一的 _id 值。
• insertOne() 方法会自动向文档添加一个 \_id 字段，即使你没有在文档中指定该字段。

详情请参考 MongoDB insertOne() 方法文档。