db. 集合.insertMany()（mongosh方法）

参数

执行操作

默认情况下，文档会按其提供的顺序插入。

• 如果 ordered 设置为 true 并且插入失败，则服务器不会继续插入记录。

• 如果 ordered 设为 false 且插入操作失败，服务器会继续插入记录。文档可按 mongod 重新排序，从而提高性能。如果使用无序 insertMany()，应用程序不应依赖插入的顺序。

在分片集合上执行操作的 ordered 列表通常比执行 unordered 列表慢，因为对于有序列表，每个操作都必须等待前一个操作完成。

批处理

驱动程序会根据 maxWriteBatchSize（即 100,000，且不可修改）对 insertMany() 数组中指定的文档进行批处理。例如，如果 insertMany() 操作包含 250,000 个文档，则驱动程序会创建三个批处理：两个批处理包含 100,000 个文档，另一个批处理包含 50,000 个文档。

如果单个批处理的错误报告变得过大，MongoDB 会截断所有剩余的错误消息。如果存在至少两条大小超过 1MB 的错误消息，这些消息将会被截断。

大小和分组机制是内部性能细节，在未来版本中可能会有变化。

集合与_id字段创建

如果该集合不存在，则insertMany()会创建该集合。

如果文档未指定 _id 字段，则 mongod 会添加 _id 字段，并为该文档分配唯一的 ObjectId()。大多数驱动程序都会创建一个 ObjectId 并插入 _id 字段，如果驱动程序或应用程序不这样做，则 mongod 将创建并填充 _id。

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

可解释性

insertMany() 与db.collection.explain() 不兼容。

Error Handling

插入会引发 BulkWriteError 异常。

不包括写关注错误，有序操作会在出错后停止，而无序操作则会继续处理队列中剩余的写入操作。

写关注错误显示在 writeConcernErrors 字段，所有其他错误则显示在 writeErrors 字段。如果遇到错误，则会显示成功写操作的数量，而不是插入的 _ids 列表。有序操作显示遇到的单个错误，而无序操作则以数组形式显示每个错误。

事务

insertMany() 可用于分布式事务。

随机数据的性能考量

如果某操作在已索引字段上插入大量随机数据（例如，哈希索引），插入性能可能会降低。随机数据的批量插入会创建随机索引条目，从而增加索引的大小。如果索引达到需要每次随机插入都访问不同索引条目的大小，则插入操作会导致较高的 WiredTiger 缓存逐出和替换速度。发生这种情况时，索引不再完全位于缓存中，而是在磁盘上更新，这会降低性能。

要提高在已索引字段上批量插入随机数据的性能，可以采用以下两种方法之一：

• 删除索引，然后在插入随机数据后重新创建该索引。

• 将数据插入一个空的无索引集合。

批量插入后创建索引会对内存中的数据排序并对所有索引执行有序插入。

Oplog 条目

MongoDB 将插入多个文档的操作（例如 insertMany() 或 db.collection.bulkWrite() 操作中的多个 insertOne() 命令）整合到 oplog 中的单个条目中。如果操作失败，则该操作不会为 oplog 添加条目。

插入多个文档而不指定 _id 字段

以下示例将三个没有 _id 字段的文档插入到 movies集合中：

db.movies.insertMany( [
   { title: "Inception", year: 2010, genres: [ "Action", "Sci-Fi" ] },
   { title: "The Matrix", year: 1999, genres: [ "Action", "Sci-Fi" ] },
   { title: "Interstellar", year: 2014, genres: [ "Adventure", "Sci-Fi" ] }
] )

{
  acknowledged: true,
  insertedIds: {
    '0': "...",
    '1': "...",
    '2': "..."
  }
}

由于文档不包含_id mongod_id，因此ObjectId() 会为每个文档创建并添加 字段，并为其分配唯一的 值。

ObjectId 值特定于运行操作时的设备和时间。因此，您的值可能与示例中的值不同。

插入多个指定 _id 字段的文档

以下示例将指定 _id字段的文档插入到 movies集合中。 _id 的值在集合内必须是唯一的，以避免重复键错误：

db.movies.insertMany( [
   { _id: 10, title: "Inception", year: 2010 },
   { _id: 11, title: "The Matrix", year: 1999 },
   { _id: 12, title: "Interstellar", year: 2014 }
] )

{
  acknowledged: true,
  insertedIds: { '0': 10, '1': 11, '2': 12 }
}

为属于唯一索引的任何键插入重复值（例如 _id）会引发异常。下面的例子中尝试插入一个已存在 _id 值的文档：

try {
   db.movies.insertMany( [
      { _id: 13, title: "Inception", year: 2010 },
      { _id: 13, title: "The Dark Knight", year: 2008 },
      { _id: 14, title: "Interstellar", year: 2014 }
   ] );
} catch (e) {
   print (e);
}

由于 _id: 13 已存在，因此会抛出以下异常：

BulkWriteError({
   "writeErrors" : [
      {
         "index" : 0,
         "code" : 11000,
         "errmsg" : "E11000 duplicate key error collection: sample_mflix.movies index: _id_ dup key: { : 13.0 }",
         "op" : {
            "_id" : 13,
            "title" : "The Dark Knight",
            "year" : 2008
         }
      }
   ],
   "writeConcernErrors" : [ ],
   "nInserted" : 1,
   "nUpserted" : 0,
   "nMatched" : 0,
   "nModified" : 0,
   "nRemoved" : 0,
   "upserted" : [ ]
})

请注意，已插入一个文档：_id: 13 的第一个文档插入成功，但第二个插入失败。该操作不会插入队列中的剩余文档。

将 ordered设立为 false 时，插入操作将继续处理剩余的文档。

无序插入

以下尝试插入具有 _id 字段和 ordered: false 的多个文档。文档数组包含两个具有重复 _id 字段的文档。

try {
   db.movies.insertMany( [
      { _id: 10, title: "Inception", year: 2010 },
      { _id: 11, title: "The Matrix", year: 1999 },
      { _id: 11, title: "Interstellar", year: 2014 },
      { _id: 12, title: "Arrival", year: 2016 },
      { _id: 13, title: "Blade Runner 2049", year: 2017 },
      { _id: 13, title: "Ex Machina", year: 2014 },
      { _id: 14, title: "Her", year: 2013 }
   ], { ordered: false } )
} catch (e) {
   print(e)
}

MongoBulkWriteError: E11000 duplicate key error collection: sample_mflix.movies index: _id_ dup key: { _id: 11 }
Result: BulkWriteResult {
  insertedCount: 5,
  matchedCount: 0,
  modifiedCount: 0,
  deletedCount: 0,
  upsertedCount: 0,
  upsertedIds: {},
  insertedIds: {
    '0': 10,
    '1': 11,
    '3': 12,
    '4': 13,
    '6': 14
  }
}
Write Errors: [
  WriteError {
    err: {
      index: 2,
      code: 11000,
      errInfo: undefined,
      errmsg: 'E11000 duplicate key error collection: sample_mflix.movies index: _id_ dup key: { _id: 11 }'
    }
  },
  WriteError {
    err: {
      index: 5,
      code: 11000,
      errInfo: undefined,
      errmsg: 'E11000 duplicate key error collection: sample_mflix.movies index: _id_ dup key: { _id: 13 }'
    }
  }
]

尽管具有 title: "Interstellar" 和 title: "Ex Machina" 的文档由于重复的 _id 值而无法插入，但 insertedCount 显示其余 5 文档插入成功。

使用写关注

给定一个三成员副本集，以下操作指定 majority 的 w 和 100 的 wtimeout：

try {
   db.movies.insertMany(
      [
         { _id: 15, title: "Forrest Gump", year: 1994 },
         { _id: 16, title: "Schindler's List", year: 1993 },
         { _id: 17, title: "Pulp Fiction", year: 1994 }
      ],
      { w: "majority", wtimeout: 100 }
   );
} catch (e) {
   print (e);
}

如果主节点和至少一个从节点在 100 毫秒内确认每个写入操作，则返回：

{
  "acknowledged" : true,
  "insertedIds" : [
     ObjectId("562a94d381cb9f1cd6eb0e1a"),
     ObjectId("562a94d381cb9f1cd6eb0e1b"),
     ObjectId("562a94d381cb9f1cd6eb0e1c")
  ]
}

如果副本集中所有必需节点确认写入操作所需的总时间大于 wtimeout，则在经过wtimeout时间段后将显示以下 writeConcernError。

此操作返回：

WriteConcernError({
   "code" : 64,
   "errmsg" : "waiting for replication timed out",
   "errInfo" : {
     "wtimeout" : true,
     "writeConcern" : {
       "w" : "majority",
       "wtimeout" : 100,
       "provenance" : "getLastErrorDefaults"
     }
   }
})