/ /

$literal (operador de expresión)

Definición

$literal

Devuelve un valor sin analizarlo. Usar para valores que el pipeline de agregación pueda interpretar como una expresión.

La expresión tiene la siguiente $literal sintaxis:

{ $literal: <value> }

Comportamiento

Si <value> es una expresión, no evalúa la expresión, sino que devuelve la expresión sin$literal analizar.

Ejemplo	Resultado
`{ $literal: { $add: [ 2, 3 ] } }`	`{ "$add" : [ 2, 3 ] }`
`{ $literal: { $literal: 1 } }`	`{ "$literal" : 1 }`

Ejemplos

Trate a `$` como un literal

En expresión, el signo de dólar $ evalúa una ruta de campo; es decir, proporciona acceso al campo. Por ejemplo, la expresión $eq $eq: [ "$price", "$1" ] realiza una comprobación de igualdad entre el valor del campo llamado price y el valor del campo llamado 1 en el documento.

El siguiente ejemplo utiliza una expresión para tratar una cadena que contiene un signo de $literal dólar "$1" como un valor constante.

Una colección storeInventory tiene los siguientes documentos:

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" } ] } } }
] )

Esta operación proyecta un campo llamado costsOneDollar que contiene un valor booleano, indicando si el valor del campo price es igual a la string "$1":

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

Proyecta un nuevo campo con valor `1`

La etapa utiliza la $project expresión <field>: 1 para incluir <field> en la salida. El siguiente ejemplo utiliza para devolver un nuevo campo establecido al $literal valor 1 de.

Una colección books tiene los siguientes documentos:

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

La expresión devuelve un { $literal: 1 } nuevo editionNumber campo establecido al 1 valor:

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

La operación da como resultado los siguientes documentos:

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

Volver

$linearFill

$ln