MongoDB $first Aggregation Pipeline Operator

MongoDB 4.4 introduceerde de $first aggregatie pijpleiding operator.

Deze operator retourneert het eerste element in een array.

Voorbeeld

Stel dat we een verzameling spelers hebben met de volgende documenten:

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

We kunnen zien dat elk document een scores . heeft veld dat een array bevat.

We kunnen $first . gebruiken om het eerste element van elk van die arrays te retourneren.

Voorbeeld:

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

Resultaat:

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

We kunnen zien dat het eerste element van de array voor elk document is geretourneerd.

Dit is het equivalent van het gebruik van de $arrayElemAt operator met een waarde van nul (0 ):

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

Lege arrays

Als u een lege array opgeeft, $first zal geen waarde retourneren.

Stel dat we het volgende document in onze collectie opnemen:

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

Laten we de code opnieuw uitvoeren:

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

Resultaat:

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

In dit geval retourneerde document 4 geen enkele waarde voor de array. Het gaf zelfs niet eens de veldnaam terug.

Null en ontbrekende waarden

Als de operand null is of ontbreekt, $first retourneert null .

Stel dat we het volgende document invoegen:

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

Laten we de code opnieuw uitvoeren:

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

Resultaat:

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

Deze keer retourneerde het het veld met een waarde van null .

Ongeldige operand

De operand voor $first moet worden omgezet in een array, null of missing. Het verstrekken van een ongeldige operand resulteert in een fout.

Laten we, om dit te demonstreren, proberen om $first . te gebruiken tegen de player veld (wat geen array is):

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

Resultaat:

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

Zoals verwacht heeft het een fout geretourneerd.