/ /

Operadores

Operadores de tuberías de agregación

Docs Home

Manual de base de datos

Referencia

Operadores

Operadores de tuberías de agregación

$first (operador de matriz)

Esta versión de la documentación está archivada y ya no recibe soporte. Para actualizar su implementación 6.0, consulte Procedimientos de actualización de MongoDB.7.0

Definición

$first: Nuevo en la versión 4.4.
Devuelve el primer elemento de una matriz.
Nota
Desambiguación
Esta página describe el operador de matriz. Para $first el $first acumulador de agregación,$first (aggregation accumulator) véase.

Tip

$last

Sintaxis

$first tiene la siguiente sintaxis:

{ $first: <expression> }

El valor <expression> puede ser cualquier expresión válida, siempre que se resuelva en una matriz, nula o inexistente. Para más información sobre expresiones, consulte Expresiones.

El operador es un $first $arrayElemAt alias para la siguiente expresión:

{ $arrayElemAt: [ <array expression>, 0 ] }

Comportamiento

Operandos válidos

El operando válido para $first debe resolverse en una matriz, nula o faltante.

Si el operando se resuelve en una matriz no vacía, devuelve el primer elemento de la$first matriz:
Si el operando se resuelve en una matriz [] vacía, no devuelve un$first valor.
Si el operando es nulo o falta, devuelve$first nulo.

Por ejemplo, cree una colección de prueba example1 con los siguientes documentos:

db.example1.insertMany([
     { "_id" : 1, "x" : [ 1, 2, 3 ] },      // Non-empty array
     { "_id" : 2, "x" : [ [ ] ] },          // Non-empty array
     { "_id" : 3, "x" : [ null ] },         // Non-empty array
     { "_id" : 4, "x" : [ ] },              // Empty array
     { "_id" : 5, "x" : null },             // Is null
     { "_id" : 6 }                          // Is Missing
])

Luego, lo siguiente agrega un nuevo campo firstElem cuyo valor se deriva de aplicar el operador $first al x campo:

db.example1.aggregate([
   { $addFields: { firstElem: { $first: "$x" } } }
])

El operador devuelve los siguientes documentos:

{ "_id" : 1, "x" : [ 1, 2, 3 ], "firstElem" : 1 }
{ "_id" : 2, "x" : [ [ ] ], "firstElem" : [ ] }
{ "_id" : 3, "x" : [ null ], "firstElem" : null }
{ "_id" : 4, "x" : [ ] }                          // No output
{ "_id" : 5, "x" : null, "firstElem" : null }
{ "_id" : 6, "firstElem" : null }

Operandos no válidos

Si el operando no se resuelve en una matriz, es nulo o falta, la operación de agregación en su conjunto genera un error.

Por ejemplo, cree una colección de prueba example2 con los siguientes documentos:

db.example2.insertMany([
   { "_id" : 1, "x" : [ 1, 2, 3 ] },
   { "_id" : 2, "x" : 2 },             // x is not an array/null or missing
])

Luego, la siguiente operación de agregación devuelve un error debido al documento { "_id" : 2, "x" : 2 }:

db.example2.aggregate( { $addFields: { firstElem: { $first: "$x" } } } )

Es decir, la operación devuelve lo siguiente:

2020-01-20T18:31:13.431-05:00 E  QUERY    [js] uncaught exception: Error: command failed: {
   "ok" : 0,
   "errmsg" : "$first's argument must be an array, but is double",
   "code" : 28689,
   "codeName" : "Location28689"
} : aggregate failed :

Ejemplo

Cree una colección de muestra runninglog con los siguientes documentos:

db.runninglog.insertMany([
   { "_id" : 1, "team" : "Anteater", log: [ { run: 1, distance: 8 }, { run2: 2, distance: 7.5 }, { run: 3, distance: 9.2 } ] },
   { "_id" : 2, "team" : "Bears", log: [ { run: 1, distance: 18 }, { run2: 2, distance: 17 }, { run: 3, distance: 16 } ] },
   { "_id" : 3, "team" : "Cobras", log: [ { run: 1, distance: 2 } ] }
])

La siguiente agregación utiliza el $first operador y $last log en la matriz para recuperar la información de la primera ejecución y la última ejecución:

db.runninglog.aggregate([
   { $addFields: { firstrun: { $first: "$log" }, lastrun: { $last: "$log" } } }
])

La operación devuelve los siguientes resultados:

{ "_id" : 1, "team" : "Anteater", "log" : [ { "run" : 1, "distance" : 8 }, { "run2" : 2, "distance" : 7.5 }, { "run" : 3, "distance" : 9.2 } ],
      "firstrun" : { "run" : 1, "distance" : 8 }, "lastrun" : { "run" : 3, "distance" : 9.2 } }
{ "_id" : 2, "team" : "Bears", "log" : [ { "run" : 1, "distance" : 18 }, { "run2" : 2, "distance" : 17 }, { "run" : 3, "distance" : 16 } ],
      "firstrun" : { "run" : 1, "distance" : 18 }, "lastrun" : { "run" : 3, "distance" : 16 } }
{ "_id" : 3, "team" : "Cobras", "log" : [ { "run" : 1, "distance" : 2 } ],
      "firstrun" : { "run" : 1, "distance" : 2 }, "lastrun" : { "run" : 1, "distance" : 2 } }

Para calcular el cambio entre la primera y la última distancia, la siguiente operación utiliza $cond los $size operadores y para calcular la diferencia (es decir,) de las dos distancias si hay dos o más elementos en$subtract la log matriz:

db.runninglog.aggregate([
  { $addFields: { firstrun: { $first: "$log" }, lastrun: { $last: "$log" } } },
  { $project: { team: 1, progress:
      {
        $cond: {
           if: { $gt: [ { $size:"$log" }, 1 ] } ,
           then: { $subtract: [ "$lastrun.distance", "$firstrun.distance"] },
           else: "Not enough data." }
      }
  }}
])

La operación devuelve los siguientes documentos:

{ "_id" : 1, "team" : "Anteater", "progress" : 1.1999999999999993 }
{ "_id" : 2, "team" : "Bears", "progress" : -2 }
{ "_id" : 3, "team" : "Cobras", "progress" : "Not enough data." }

De forma predeterminada, usamongosh el 64doble de coma flotante de bits para números. Para mejorar128 la precisión, puede usar Decimal en su lugar.

Ver también

Volver

$firstN

$floor