$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 }