插

定义¶

insert¶

该insert命令将插入一个或多个文档，并返回包含所有插入状态的文档。MongoDB驱动程序提供的插入方法在内部使用此命令。

该命令具有以下语法：

复制

{
   insert: <collection>,
   documents: [ <document>, <document>, <document>, ... ],
   ordered: <boolean>,
   writeConcern: { <write concern> },
   bypassDocumentValidation: <boolean>
}

该insert命令包含以下字段：

领域	类型	描述
insert	串	目标集合的名称。
documents	数组	一个或多个要插入命名集合的文档的数组。
ordered	布尔值	可选的。如果为true，则在插入文档失败时返回，而不插入inserts数组中列出的任何剩余文档。如果为 false，则在插入文档失败时，继续插入其余文档。默认为true。
writeConcern	文献	可选的。表示命令的写关注点 的文档insert。省略使用默认的写关注。 如果在事务中运行，则不要为操作明确设置写关注点。要对事务使用写关注，请参见 事务和写关注。
bypassDocumentValidation	布尔值	可选的。允许insert在操作过程中绕过文档验证。这使您可以插入不符合验证要求的文档。 3.2版中的新功能。

返回值：	包含操作状态的文档。有关详细信息，请参见输出。

行为¶

例子¶

db.runCommand(
   {
      insert: "users",
      documents: [ { _id: 1, user: "abc123", status: "A" } ]
   }
)

{ "ok" : 1, "n" : 1 }

db.runCommand(
   {
      insert: "users",
      documents: [
         { _id: 2, user: "ijk123", status: "A" },
         { _id: 3, user: "xyz123", status: "P" },
         { _id: 4, user: "mop123", status: "P" }
      ],
      ordered: false,
      writeConcern: { w: "majority", wtimeout: 5000 }
   }
)

{ "ok" : 1, "n" : 3 }

输出¶

返回的文档包含以下字段的子集：

insert.ok¶

命令的状态。

insert.n¶

插入的文档数。

insert.writeErrors¶

文档数组，其中包含有关在插入操作期间遇到的任何错误的信息。该 writeErrors数组包含每个插入错误的错误文档。

每个错误文档均包含以下字段：

insert.writeErrors.index¶

一个整数，用于标识documents数组中的文档，该文档 使用从零开始的索引。

insert.writeErrors.code¶

标识错误的整数值。

insert.writeErrors.errmsg¶

错误的描述。

insert.writeConcernError¶

描述与写关注有关的错误的文档，其中包含以下字段：

insert.writeConcernError.code¶

标识写关注错误原因的整数值。

insert.writeConcernError.errmsg¶

写关注错误原因的描述。

以下是成功返回insert单个文档的示例 文档：

{ ok: 1, n: 1 }

以下是insert为两个文档中的一个成功返回的示例文档，该 文档已成功插入一个文档，但另一个文档遇到错误：

{
   "ok" : 1,
   "n" : 1,
   "writeErrors" : [
      {
         "index" : 1,
         "code" : 11000,
         "errmsg" : "insertDocument :: caused by :: 11000 E11000 duplicate key error index: test.users.$_id_  dup key: { : 1.0 }"
      }
   ]
}