db.collection.insert（）_MonogDB 中文网

MongoDB 中文手册

参考 > 参考 > mongo Shell方法 > 收集方法 > db.collection.insert（）

在本页面

定义
行为举止
例子
写结果
BulkWriteResult

定义¶

db.collection.insert（）¶

mongo 壳法

此页面记录了mongoshell方法，并且没有引用MongoDB Node.js驱动程序（或任何其他驱动程序）方法。对于相应的MongoDB驱动程序API，请改为参考您特定的 MongoDB驱动程序文档。

将一个或多个文档插入集合中。

该insert()方法具有以下语法：

复制

db.collection.insert(
   <document or array of documents>,
   {
     writeConcern: <document>,
     ordered: <boolean>
   }
)

参数	类型	描述
`document`	文件或阵列	要插入集合的文档或文档数组。
`writeConcern`	文献	可选的。表达书面关切的文件。省略使用默认的写关注。请参阅写关注点。如果在事务中运行，则不要为操作明确设置写关注点。要对事务使用写关注，请参见事务和写关注。
`ordered`	布尔值	可选的。如果为`true`，请按顺序在数组中插入文档，并且如果其中一个文档发生错误，则MongoDB将返回而不处理数组中的其余文档。如果为`false`，请执行无序插入，并且如果其中一个文档发生错误，请继续处理数组中的其余文档。默认为`true`。

该insert()返回包含操作的状态的对象。

返回值：	甲写结果对象用于单个刀片。甲BulkWriteResult对象对于批量插入。

行为¶

写关注¶

该insert()方法使用 insert命令，该命令使用默认的写入关注。要指定其他写关注点，请在options参数中包括写关注点。

创建集合¶

如果该集合不存在，则该 insert()方法将创建该集合。

`_id`字段¶

如果文档未指定_id字段，则MongoDB将添加该_id字段并ObjectId为文档分配唯一的位置，然后再进行插入。大多数驱动程序会创建一个ObjectId并插入_id字段，但如果驱动程序或应用程序未mongod创建，则会创建并填充_id。

如果文档包含一个_id字段，则该_id值在集合中必须唯一，以避免重复的键错误。

交易¶

db.collection.insert()可以在多文档交易中使用。

集合必须已经存在。事务中不允许执行会导致创建新集合的插入操作。

如果在事务中运行，则不要为操作明确设置写关注点。要对事务使用写关注，请参见事务和写关注。

重要

在大多数情况下，与单文档写入相比，多文档事务产生的性能成本更高，并且多文档事务的可用性不应代替有效的架构设计。在许多情况下，非规范化数据模型（嵌入式文档和数组）对于您的数据和用例将继续是最佳的。也就是说，在许多情况下，对数据进行适当的建模将最大程度地减少对多文档交易的需求。

有关其他事务使用方面的注意事项（例如运行时限制和oplog大小限制），另请参见生产注意事项。

例子¶

以下示例将文档插入products 集合中。如果该集合不存在，则该 insert()方法将创建该集合。

插入文档而不指定`_id`字段¶

在以下示例中，传递给该insert()方法的文档不包含该_id 字段：

复制

db.products.insert( { item: "card", qty: 15 } )

在插入过程中，mongod将创建该_id字段并为其指定一个唯一ObjectId值，该值已由插入的文档验证：

复制

{ "_id" : ObjectId("5063114bd386d8fadbd6b004"), "item" : "card", "qty" : 15 }

这些ObjectId值特定于机器和运行该操作的时间。因此，您的值可能与示例中的值不同。

插入指定`_id`字段的文档¶

在以下示例中，传递给该insert()方法的文档包括该_id字段。值_id在集合中必须唯一，以避免重复的键错误。

复制

db.products.insert( { _id: 10, item: "box", qty: 20 } )

该操作将以下文档插入products 集合中：

复制

{ "_id" : 10, "item" : "box", "qty" : 20 }

插入多个文件¶

下面的示例通过将文档数组传递给该insert() 方法来执行三个文档的批量插入。默认情况下，MongoDB执行有序插入。对于有序插入，如果在插入其中一个文档期间发生错误，则MongoDB会返回错误，而不会处理数组中的其余文档。

数组中的文档不需要具有相同的字段。例如，数组中的第一个文档具有一个_id字段和一个 type字段。由于第二和第三文档不包含_id字段，因此mongod将_id在插入期间为第二和第三文档创建该字段：

复制

db.products.insert(
   [
     { _id: 11, item: "pencil", qty: 50, type: "no.2" },
     { item: "pen", qty: 20 },
     { item: "eraser", qty: 25 }
   ]
)

该操作插入了以下三个文档：

复制

{ "_id" : 11, "item" : "pencil", "qty" : 50, "type" : "no.2" }
{ "_id" : ObjectId("51e0373c6f35bd826f47e9a0"), "item" : "pen", "qty" : 20 }
{ "_id" : ObjectId("51e0373c6f35bd826f47e9a1"), "item" : "eraser", "qty" : 25 }

执行无序插入¶

下面的示例执行三个文档的无序插入。对于无序插入，如果在插入其中一个文档期间发生错误，MongoDB会继续将其余文档插入阵列中。

复制

db.products.insert(
   [
     { _id: 20, item: "lamp", qty: 50, type: "desk" },
     { _id: 21, item: "lamp", qty: 20, type: "floor" },
     { _id: 22, item: "bulk", qty: 100 }
   ],
   { ordered: false }
)

覆盖默认写问题¶

通过以下操作来副本集指定一个写关注的带的5000毫秒，使得写入传播到多数表决副本集成员或方法倍的出5秒后之后该方法返回。"w: majority"wtimeout

复制

db.products.insert(
    { item: "envelopes", qty : 100, type: "Clasp" },
    { writeConcern: { w: "majority", wtimeout: 5000 } }
)

写结果¶

当传递单个文档时，insert() 返回一个WriteResult对象。

成功的结果¶

将insert()返回WriteResult 一个包含操作的状态对象。成功后，该 WriteResult对象将包含有关插入的文档数的信息：

复制

WriteResult({ "nInserted" : 1 })

写关注错误¶

如果该insert()方法遇到写关注错误，则结果包括以下 WriteResult.writeConcernError字段：

复制

WriteResult({
   "nInserted" : 1,
   "writeConcernError" : {
      "code" : 64,
      "errmsg" : "waiting for replication timed out at shard-a"
   }
})

与写关注无关的错误¶

如果该insert()方法遇到非写关注错误，则结果包括以下WriteResult.writeError 字段：

复制

WriteResult({
   "nInserted" : 0,
   "writeError" : {
      "code" : 11000,
      "errmsg" : "insertDocument :: caused by :: 11000 E11000 duplicate key error index: test.foo.$_id_  dup key: { : 1.0 }"
   }
})

BulkWriteResult ¶

传递文档数组时，insert() 返回一个BulkWriteResult()对象。有关BulkWriteResult()详细信息，请参见。

MongoDB 中文手册

db.collection.insert（）

定义¶

行为¶

写关注¶

创建集合¶

_id字段¶

交易¶

例子¶

插入文档而不指定_id字段¶

插入指定_id字段的文档¶

插入多个文件¶

执行无序插入¶

覆盖默认写问题¶

写结果¶

成功的结果¶

写关注错误¶

与写关注无关的错误¶

BulkWriteResult ¶

`_id`字段¶

插入文档而不指定`_id`字段¶

插入指定`_id`字段的文档¶