db.collection.insert()

在本页面

• Definition

• Behaviors

• Examples

• WriteResult

• BulkWriteResult

Definition

• db.collection. insert ( )
  • 将一个或多个文档插入集合中。

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

在 2.6 版中进行了更改。

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

2.6 版中的新功能。
| ordered |布尔值|可选。如果true，请按 Sequences 在数组中插入文档，并且如果其中一个文档发生错误，则 MongoDB 将返回而不处理数组中的其余文档。
如果false，则执行无序插入，并且如果其中一个文档发生错误，请 continue 处理数组中的其余文档。
默认为true。
2.6 版中的新功能。

在 2.6 版中进行了更改：insert()返回一个包含操作状态的对象。

Behaviors

Write Concern

在 2.6 版中进行了更改。

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

Create Collection

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

_id Field

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

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

Examples

以下示例将文档插入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 执行“有序”插入。对于* ordered *插入，如果在插入其中一个文档期间发生错误，则 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 }

执行无序插入

以下示例对三个文档执行“无序”插入。对于* unordered *插入，如果在插入一个文档中发生错误，MongoDB 会 continue 将其余文档插入数组中。

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 }
)

覆盖默认写问题

对副本集的以下操作指定"w: majority"的write concern和wtimeout的 5000 毫秒，以使该方法在写入传播到大多数有表决权的副本集成员之后返回，或者该方法在 5 秒钟后超时。

在版本 3.0 中进行了更改：在以前的版本中，majority引用了副本集的所有成员的大多数，而不是多数投票成员。

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

WriteResult

在 2.6 版中进行了更改。

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

Successful Results

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

在 2.6 版中进行了更改。

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