Definición
$literalDevuelve un valor sin analizar. Se utiliza para valores que la canalización de agregación pueda interpretar como una expresión.
La expresión
$literaltiene la siguiente sintaxis:{ $literal: <value> }
Comportamiento
Si el <value> es un expresión, no evalúa la expresión sino que devuelve la expresión sin$literal analizar.
Ejemplo | Resultado |
|---|---|
|
|
|
|
Ejemplos
Tratar $ como un literal
En una expresión, el signo de dólar se $ evalúa como una ruta de campo; es decir, proporciona acceso al campo. Por ejemplo, la $eq expresión $eq: [
"$price", "$1" ] realiza una comprobación de igualdad entre el valor del campo price y el valor del campo 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, que indica si el valor del campo price es igual a la cadena "$1":
{ "_id" : 1, "costsOneDollar" : false } { "_id" : 2, "costsOneDollar" : false } { "_id" : 3, "costsOneDollar" : true }
Proyectar un nuevo campo con valor 1
La etapa usa la $project expresión <field>: 1 para incluir <field> en la salida. El siguiente ejemplo usa para devolver un nuevo campo con $literal el 1 valor.
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 en el 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 }