/ /

$getField（表达式操作符）

定义

$getField

版本 5.0 中的新增功能。

返回文档中指定字段的值。如果未指定对象，$getField 将返回$$CURRENT 中的字段值。

您可以使用检索名称中包含句点$getField (). 或以美元符号 ()检索的字段的值。$

请勿依赖与保留的内部元数据字段名称冲突的根级前缀为美元的字段名称，因为在某些查询处理上下文中，这些字段可能会被删除或无法访问。有关包含美元符 ($)或句号 (.)的字段名称的限制和指导，请参阅带有句号和美元符的字段名称。

提示

使用 $setField 添加名称中包含美元符号 ($) 或句点 (.) 的字段。

语法

$getField 通过以下语法实现：

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

字段	类型	说明
`field`	字符串	要返回值的输入对象。在版本 7.2 中进行了更改： `field` 接受解析为 string 的任何有效表达式。如果 `field` 以美元符号 (`$`) 开头，则将字段名称放在 `$literal` 表达式中以返回其值。
`input`	对象	默认值：`$$CURRENT` 一个有效的表达式，包含要返回值的 `field`。`input` 必须解析为对象、`missing`、`null` 或 `undefined`。如果省略，则默认为管道中当前正在处理的文档 (`$$CURRENT`)。

$getField使用以下速记语法从检索字段值：$$CURRENT

{
  $getField: <String>
}

对于此语法，参数等效于上述 field 的值。

行为

如果您指定的field 不在input 对象中，或者在中（如果您未指定$$CURRENT 对象），则input $getField将返回missing 。
inputmissingundefined如果null 的计算结果为、$getField 或，则null 返回。
input如果missing 的计算结果为对象、undefined 、或null 以外的任何值，$getField 将返回错误。
$getField不会隐式遍历对象或数组。示例，$getField field将的a.b.c 值计算为顶级字段a.b.c ，而不是嵌套字段{ a: { b: { c: } } } 。

提示

针对字段名称的注意事项

示例

包含句点 () 的查询字段`.`

考虑包含以下文档的 inventory 集合：

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

以下操作使用$getField 和$gt 操作符来查找哪些产品的price.usd 大于200 ：

db.inventory.aggregate( [
  {
    $match:
      { $expr:
        { $gt: [ { $getField: "price.usd" }, 200 ] }
      }
   }
] )

操作返回以下结果：

[
  { _id: 2, item: 'winter coat', qty: 200, 'price.usd': 499.99 },
  { _id: 4, item: 'leather boots', qty: 300, 'price.usd': 249.99 }
]

以美元符号 (`$`) 开头的查询字段

考虑包含以下文档的 inventory 集合：

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

以下操作使用$getField 、$gt 和$literal 操作符来查找哪些产品的$price 大于200 ：

db.inventory.aggregate( [
  {
    $match:
      { $expr:
        { $gt: [ { $getField: {$literal: "$price" } }, 200 ] }
      }
   }
] )

操作返回以下结果：

[
  { _id: 2, item: 'winter coat', qty: 200, '$price': 499.99 },
  { _id: 4, item: 'leather boots', qty: 300, '$price': 249.99 }
]

查询子文档中的字段

使用以下文档创建 inventory 集合：

db.inventory.insertMany( [
   { _id: 1, item: "sweatshirt",  "price.usd": 45.99,
     quantity: { "$large": 50, "$medium": 50, "$small": 25 }
   },
   { _id: 2, item: "winter coat", "price.usd": 499.99,
     quantity: { "$large": 35, "$medium": 35, "$small": 35 }
   },
   { _id: 3, item: "sun dress", "price.usd": 199.99,
     quantity: { "$large": 45, "$medium": 40, "$small": 5 }
   },
   { _id: 4, item: "leather boots", "price.usd": 249.99,
     quantity: { "$large": 20, "$medium": 30, "$small": 40 }
   },
   { _id: 5, item: "bow tie", "price.usd": 9.99,
     quantity: { "$large": 0, "$medium": 10, "$small": 75 }
   }
] )

以下操作将返回 $small 项的数量小于或等于 20 的文档。

db.inventory.aggregate( [
   { $match:
      { $expr:
         { $lte:
            [
               { $getField:
                  { field: { $literal: "$small" },
                    input: "$quantity"
                  }
               },
               20
            ]
         }
      }
   }
] )

使用这些操作符来查询集合：

$lte 操作符查找小于等于 20 的值。
$getField需要显式field input和$small 参数，因为字段是子文档的一部分。
$getField使用$literal $small来评估“”，因为字段名称中包含一个美元符号$ ()。

示例输出：

[
  {
    _id: 3,
    item: 'sun dress',
    'price.usd': 199.99,
    quantity: { '$large': 45, '$medium': 40, '$small': 5 }
  }
]

$getField（表达式操作符）

定义

提示

语法

行为

提示

示例

包含句点 () 的查询字段.

以美元符号 ($) 开头的查询字段

查询子文档中的字段

包含句点 () 的查询字段`.`

以美元符号 (`$`) 开头的查询字段