Docs 菜单
Docs 主页
/
MongoDB Manual
/
聚合操作
/
参考
/
操作符

$literal（聚合）

在此页面上

  • 定义
  • 行为
  • 示例

定义

$literal

返回一个值而不进行解析。用于聚合管道可解释为表达式的值。

$literal 表达式的语法如下：

{ $literal: <value> }

行为

如果<value>是表达式，则$literal不会计算该表达式，而是返回未解析的表达式。

例子
结果

{ $literal: { $add: [ 2, 3 ] } }

{ "$add" : [ 2, 3 ] }

{ $literal: { $literal: 1 } }

{ "$literal" : 1 }

示例

将$ 视为文字

在表达式中，美元符号 $ 的计算结果为字段路径；即提供对字段的访问权限。例如，$eq 表达式 $eq: [ "$price", "$1" ] 在文档中 price 字段中的值和 1 字段中的值之间执行相等性检查。

以下示例使用 $literal 表达式，以将包含美元符号 "$1" 的字符串处理为常量值。

集合 storeInventory 包含以下文档：

db.storeInventory.insertMany( [
   { "_id" : 1, "item" : "napkins", price: "$2.50" },
   { "_id" : 2, "item" : "coffee", price: "1" },
   { "_id" : 3, "item" : "soap", price: "$1" }
] )
db.storeInventory.aggregate( [
   { $project: { costsOneDollar: { $eq: [ "$price", { $literal: "$1" } ] } } }
] )

此操作投影一个名为 costsOneDollar 的字段，该字段包含布尔值，指示 price 字段的值是否等于字符串 "$1"：

{ "_id" : 1, "costsOneDollar" : false }
{ "_id" : 2, "costsOneDollar" : false }
{ "_id" : 3, "costsOneDollar" : true }

投影新字段，值为 1

$project 阶段使用表达式 <field>: 1 将 <field> 包含在输出中。下面的示例使用 $literal，返回设置为 1 值的新字段。

集合 books 包含以下文档：

db.books.insertMany([
   { "_id" : 1, "title" : "Dracula", "condition": "new" },
   { "_id" : 2, "title" : "The Little Prince", "condition": "new" }
])

{ $literal: 1 } 表达式返回一个新的 editionNumber 字段，值设为 1：

db.books.aggregate( [
   { $project: { "title": 1, "editionNumber": { $literal: 1 } } }
] )

该操作生成以下文档：

{ "_id" : 1, "title" : "Dracula", "editionNumber" : 1 }
{ "_id" : 2, "title" : "The Little Prince", "editionNumber" : 1 }

后退

$linearFill

来年

$ln

在此页面上