删除

定义¶

delete¶

该delete命令从集合中删除文档。一个delete命令可以包含多个删除规范。该命令无法对有上限的集合进行操作。MongoDB驱动程序提供的删除方法在内部使用此命令。

该delete命令具有以下语法：

复制

{
   delete: <collection>,
   deletes: [
      { q : <query>, limit : <integer>, collation: <document> },
      { q : <query>, limit : <integer>, collation: <document> },
      { q : <query>, limit : <integer>, collation: <document> },
      ...
   ],
   ordered: <boolean>,
   writeConcern: { <write concern> }
}

该命令包含以下字段：

领域	类型	描述
delete	串	目标集合的名称。
deletes	数组	要在命名集合中执行的一个或多个delete语句的数组。
ordered	布尔值	可选的。如果为true，则当delete语句失败时，不执行其余的delete语句就返回。如果为false，则当delete语句失败时，请继续其余的delete语句（如果有）。默认为true。
writeConcern	文献	可选的。表示命令写关注点 的文档delete。省略使用默认的写关注。 如果在事务中运行，则不要为操作明确设置写关注点。要对事务使用写关注，请参见 事务和写关注。

deletes数组的每个元素包含以下字段：

领域	类型	描述
q	文献	与要删除的文档匹配的查询。
limit	整数	要删除的匹配文档数。指定a 0删除所有匹配的文档或1删除单个文档。
collation	文献	可选的。 指定 用于操作的排序规则。 归类允许用户为字符串比较指定特定于语言的规则，例如字母大写和重音符号的规则。 排序规则选项具有以下语法： 复制 collation: { locale: <string>, caseLevel: <boolean>, caseFirst: <string>, strength: <int>, numericOrdering: <boolean>, alternate: <string>, maxVariable: <string>, backwards: <boolean> } 指定排序规则时，该locale字段为必填字段；所有其他排序规则字段都是可选的。有关字段的说明，请参见整理文档。 如果未指定排序规则，但是集合具有默认排序规则（请参阅参考资料db.createCollection()），则该操作将使用为集合指定的排序规则。 如果没有为集合或操作指定排序规则，则MongoDB使用先前版本中使用的简单二进制比较进行字符串比较。 您不能为一个操作指定多个排序规则。例如，您不能为每个字段指定不同的排序规则，或者如果对排序执行查找，则不能对查找使用一种排序规则，而对排序使用另一种排序规则。 3.4版的新功能。

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

行为¶

例子¶

db.runCommand(
   {
      delete: "orders",
      deletes: [ { q: { status: "D" }, limit: 1 } ]
   }
)

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

db.runCommand(
   {
      delete: "orders",
      deletes: [ { q: { status: "D" }, limit: 0 } ],
      writeConcern: { w: "majority", wtimeout: 5000 }
   }
)

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

db.runCommand(
   {
      delete: "orders",
      deletes: [ { q: { }, limit: 0 } ],
      writeConcern: { w: "majority", wtimeout: 5000 }
   }
)

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

db.runCommand(
   {
      delete: "orders",
      deletes: [
         { q: { status: "D" }, limit: 0 },
         { q: { cust_num: 99999, item: "abc123", status: "A" }, limit: 1 }
      ],
      ordered: false,
      writeConcern: { w: 1 }
   }
)

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

{ _id: 1, category: "café", status: "A" }
{ _id: 2, category: "cafe", status: "a" }
{ _id: 3, category: "cafE", status: "a" }

db.runCommand({
   delete: "myColl",
   deletes: [
     { q: { category: "cafe", status: "a" }, limit: 0, collation: { locale: "fr", strength: 1 } }
   ]
})

输出¶

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

delete.ok¶

命令的状态。

delete.n¶

删除的文件数。

delete.writeErrors¶

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

每个错误文档均包含以下信息：

delete.writeErrors.index¶

一个整数，用于标识deletes数组中的delete语句，该语句 使用从零开始的索引。

delete.writeErrors.code¶

标识错误的整数值。

delete.writeErrors.errmsg¶

错误的描述。

delete.writeConcernError¶

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

delete.writeConcernError.code¶

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

delete.writeConcernError.errmsg¶

写关注错误原因的描述。

以下是为成功delete命令返回的示例文档 ：

{ ok: 1, n: 1 }

以下是为delete 遇到错误的命令返回的示例文档：

{
   "ok" : 1,
   "n" : 0,
   "writeErrors" : [
      {
         "index" : 0,
         "code" : 10101,
         "errmsg" : "can't remove from a capped collection: test.cappedLog"
      }
   ]
}