MongoDB $first Aggregation Pipeline Operator

MongoDB 4.4 hat den $first eingeführt Aggregations-Pipeline-Betreiber.

Dieser Operator gibt das erste Element in einem Array zurück.

Beispiel

Angenommen, wir haben eine Sammlung namens Spieler mit den folgenden Dokumenten:

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

Wir können sehen, dass jedes Dokument einen scores hat Feld, das ein Array enthält.

Wir können $first verwenden um das erste Element jedes dieser Arrays zurückzugeben.

Beispiel:

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

Ergebnis:

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

Wir können sehen, dass das erste Element des Arrays für jedes Dokument zurückgegeben wurde.

Dies entspricht der Verwendung von $arrayElemAt Operator mit dem Wert Null (0 ):

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

Leere Arrays

Wenn Sie ein leeres Array angeben, $first gibt keinen Wert zurück.

Angenommen, wir fügen das folgende Dokument in unsere Sammlung ein:

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

Lassen Sie uns den Code erneut ausführen:

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

Ergebnis:

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

In diesem Fall hat Dokument 4 keinen Wert für das Array zurückgegeben. Tatsächlich wurde nicht einmal der Feldname zurückgegeben.

Nullwerte und fehlende Werte

Wenn der Operand null ist oder fehlt, $first gibt null zurück .

Angenommen, wir fügen das folgende Dokument ein:

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

Lassen Sie uns den Code erneut ausführen:

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

Ergebnis:

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

Dieses Mal wurde das Feld mit dem Wert null zurückgegeben .

Ungültiger Operand

Der Operand für $first muss in ein Array aufgelöst werden, null oder fehlend. Die Angabe eines ungültigen Operanden führt zu einem Fehler.

Um dies zu demonstrieren, versuchen wir, $first zu verwenden gegen den player Feld (das kein Array ist):

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

Ergebnis:

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

Wie erwartet wurde ein Fehler zurückgegeben.