MongoDB $first Aggregation Pipeline Operator

MongoDB 4.4 introducerede $first aggregeringsrørledningsoperatør.

Denne operator returnerer det første element i et array.

Eksempel

Antag, at vi har en samling kaldet spillere med følgende dokumenter:

{ "_id" : 1, "player" : "Homer", "scores" : [ 1, 5, 3 ] }
{ "_id" : 2, "player" : "Marge", "scores" : [ 8, 17, 18 ] }
{ "_id" : 3, "player" : "Bart", "scores" : [ 15, 11, 8 ] }

Vi kan se, at hvert dokument har en scores felt, der indeholder en matrix.

Vi kan bruge $first for at returnere det første element i hver af disse arrays.

Eksempel:

db.players.aggregate([ 
  {
    $project: {
        "firstScore": { 
          $first: "$scores" 
        }
    }
  } 
])

Resultat:

{ "_id" : 1, "firstScore" : 1 }
{ "_id" : 2, "firstScore" : 8 }
{ "_id" : 3, "firstScore" : 15 }

Vi kan se, at det første element i arrayet blev returneret for hvert dokument.

Dette svarer til at bruge $arrayElemAt operator med værdien nul (0 ):

db.players.aggregate([
  {
    $project: {
      "firstScore": { $arrayElemAt: [ "$scores", 0 ] }
    }
  }
])

Tomme arrays

Hvis du angiver et tomt array, $first returnerer ikke en værdi.

Antag, at vi indsætter følgende dokument i vores samling:

{ "_id" : 4, "player" : "Farnsworth", "scores" : [ ] }

Lad os køre koden igen:

db.players.aggregate([ 
  {
    $project: {
        "firstScore": { 
          $first: "$scores" 
        }
    }
  } 
])

Resultat:

{ "_id" : 1, "firstScore" : 1 }
{ "_id" : 2, "firstScore" : 8 }
{ "_id" : 3, "firstScore" : 15 }
{ "_id" : 4 }

I dette tilfælde returnerede dokument 4 ikke nogen værdi for arrayet. Faktisk returnerede det ikke engang feltnavnet.

Nul og manglende værdier

Hvis operanden er nul eller mangler, $first returnerer null .

Antag, at vi indsætter følgende dokument:

{ "_id" : 5, "player" : "Meg", "scores" : null }

Lad os køre koden igen:

db.players.aggregate([ 
  {
    $project: {
        "firstScore": { 
          $first: "$scores" 
        }
    }
  } 
])

Resultat:

{ "_id" : 1, "firstScore" : 1 }
{ "_id" : 2, "firstScore" : 8 }
{ "_id" : 3, "firstScore" : 15 }
{ "_id" : 4 }
{ "_id" : 5, "firstScore" : null }

Denne gang returnerede den feltet med værdien null .

Ugyldig operand

Operaanden for $first skal løses til et array, null eller mangler. Angivelse af en ugyldig operand resulterer i en fejl.

For at demonstrere dette, lad os prøve at bruge $first mod player felt (som ikke er et array):

db.players.aggregate([ 
  {
    $project: {
        "firstPlayer": { 
          $first: "$player" 
        }
    }
  } 
])

Resultat:

Error: command failed: {
	"ok" : 0,
	"errmsg" : "$first's argument must be an array, but is string",
	"code" : 28689,
	"codeName" : "Location28689"
} : aggregate failed :
[email protected]/mongo/shell/utils.js:25:13
[email protected]/mongo/shell/assert.js:18:14
[email protected]/mongo/shell/assert.js:618:17
[email protected]/mongo/shell/assert.js:708:16
[email protected]/mongo/shell/db.js:266:5
[email protected]/mongo/shell/collection.js:1046:12
@(shell):1:1

Som forventet returnerede den en fejl.