/ /

$unsetField（表达式操作符）

定义

$unsetField

版本 5.0 中的新增功能。

删除文档中的指定字段。

您可以使用$unsetField 删除名称中包含句点. () 或以美元符号 ()$ 开头的字段。

$unsetField是$setField $$REMOVE的别名，使用删除字段。

语法

$unsetField 通过以下语法实现：

{
   $unsetField: {
      field: <String>,
      input: <Object>,
   }
}

您必须提供以下字段：

字段	类型	说明
`field`	字符串	要删除的 `input`对象中的字段。 `field`可以是解析为字符串常量的任何有效表达式。
`input`	对象	包含要删除的 `field` 的文档。 `input` 必须解析为对象、`missing`、`null` 或 `undefined`。

行为

inputmissingundefined如果null 的计算结果为、或$unsetField ，将返回null 并且不会更新input 。
input如果missing 的计算结果为对象、undefined 、或null 以外的任何值，$unsetField 将返回错误。
如果field 解析为字符串常量以外的任何值，则$unsetField 将返回错误。
$unsetField不会隐式遍历对象或数组。示例，$unsetField field将的"a.b.c" 值计算为顶级字段，而不是嵌套字段"a.b.c" { "a": { "b": { "c": } } }。

示例

删除包含句点 (`.`) 的字段

以库存集合为例：

db.inventory.insertMany( [
   { _id: 1, item: "sweatshirt", qty: 300, "price.usd": 45.99 },
   { _id: 2, item: "winter coat", qty: 200, "price.usd": 499.99 },
   { _id: 3, item: "sun dress", qty: 250, "price.usd": 199.99 },
   { _id: 4, item: "leather boots", qty: 300, "price.usd": 249.99 },
   { _id: 5, item: "bow tie", qty: 180, "price.usd": 9.99 }
 ] )

使用$replaceWith 管道阶段和$unsetField "price.usd"操作符从每个文档中删除字段：

db.inventory.aggregate( [
   { $replaceWith: {
        $unsetField: {
           field: "price.usd",
           input: "$$ROOT"
   } } }
 ] )

操作返回以下结果：

[
  { _id: 1, item: 'sweatshirt', qty: 300 },
  { _id: 2, item: 'winter coat', qty: 200 },
  { _id: 3, item: 'sun dress', qty: 250 },
  { _id: 4, item: 'leather boots', qty: 300 },
  { _id: 5, item: 'bow tie', qty: 180 }
]

删除以美元符号 (`$`) 开头的字段

以库存集合为例：

db.inventory.insertMany( [
   { _id: 1, item: "sweatshirt", qty: 300, "$price": 45.99 },
   { _id: 2, item: "winter coat", qty: 200, "$price": 499.99 },
   { _id: 3, item: "sun dress", qty: 250, "$price": 199.99 },
   { _id: 4, item: "leather boots", qty: 300, "$price": 249.99 },
   { _id: 5, item: "bow tie", qty: 180, "$price": 9.99 }
 ] )

使用$replaceWith 管道阶段以及$unsetField 和$literal "$price"操作符从每个文档中删除字段：

db.inventory.aggregate( [
   { $replaceWith: {
        $unsetField: {
           field: { $literal: "$price" },
           input: "$$ROOT"
   } } }
] )

操作返回以下结果：

[
  { _id: 1, item: 'sweatshirt', qty: 300 },
  { _id: 2, item: 'winter coat', qty: 200 },
  { _id: 3, item: 'sun dress', qty: 250 },
  { _id: 4, item: 'leather boots', qty: 300 },
  { _id: 5, item: 'bow tie', qty: 180 }
]

删除子字段

以库存集合为例：

db.inventory.insertMany( [
   { _id: 1, item: "sweatshirt", qty: 300, "price": {"usd":45.99, "euro": 38.77 } },
   { _id: 2, item: "winter coat", qty: 200, "price": { "usd": 499.99, "euro": 420.51 } },
   { _id: 3, item: "sun dress", qty: 250, "price": { "usd": 199.99, "euro": 167.70 } },
   { _id: 4, item: "leather boots", qty: 300, "price": { "usd": 249.99, "euro": 210.68 } },
   { _id: 5, item: "bow tie", qty: 180, "price": { "usd": 9.99, "euro": 8.42 } }
 ] )

"price" 字段包含一个具有两个子字段的文档，即 "usd" 和 "euro"。无法使用 "price.euro" 来识别和删除 "euro" ，因为 MongoDB 将 "price.euro"解析为恰好包含句点 (.) 的顶级字段名称。

使用带有的$replaceWith 管道阶段和嵌套的$setField $unsetField操作来删除"euro" 字段：

db.inventory.aggregate( [
   { $replaceWith: {
        $setField: {
           field: "price",
           input: "$$ROOT",
           value: {
              $unsetField: {
                 field: "euro",
                 input: { $getField: "price" }
   } } } } }
] )

操作返回以下结果：

[
   { _id: 1, item: "sweatshirt", qty: 300, price: { usd: 45.99 } },
   { _id: 2, item: "winter coat", qty: 200, price: { usd: 499.99 } },
   { _id: 3, item: "sun dress", qty: 250, price: { usd: 199.99 } },
   { _id: 4, item: "leather boots", qty: 300, price: { usd: 249.99 } },
   { _id: 5, item: "bow tie", qty: 180, price: { usd: 9.99 } }
]

了解详情

$unsetField（表达式操作符）

定义

语法

行为

示例

删除包含句点 (.) 的字段

删除以美元符号 ($) 开头的字段

删除子字段

了解详情

删除包含句点 (`.`) 的字段

删除以美元符号 (`$`) 开头的字段