MongoDB $ostatni operator potoku agregacji

MongoDB 4.4 wprowadził $last operator potoku agregacji.

Ten operator zwraca ostatni element tablicy.

Przykład

Załóżmy, że mamy kolekcję zwaną graczami z następującymi dokumentami:

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

Widzimy, że każdy dokument ma scores pole zawierające tablicę.

Możemy użyć $last aby zwrócić ostatni element każdej z tych tablic.

Przykład:

db.players.aggregate([ 
  {
    $project: {
        "lastScore": { 
          $last: "$scores" 
        }
    }
  } 
])

Wynik:

{ "_id" : 1, "lastScore" : 3 }
{ "_id" : 2, "lastScore" : 18 }
{ "_id" : 3, "lastScore" : 8 }

Widzimy, że ostatni element tablicy został zwrócony dla każdego dokumentu.

Jest to odpowiednik użycia $arrayElemAt operator o wartości -1 :

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

Puste tablice

Jeśli podasz pustą tablicę, $last nie zwróci wartości.

Załóżmy, że wstawiamy do naszej kolekcji następujący dokument:

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

Uruchommy kod ponownie:

db.players.aggregate([ 
  {
    $project: {
        "lastScore": { 
          $last: "$scores" 
        }
    }
  } 
])

Wynik:

{ "_id" : 1, "lastScore" : 3 }
{ "_id" : 2, "lastScore" : 18 }
{ "_id" : 3, "lastScore" : 8 }
{ "_id" : 4 }

W tym przypadku dokument 4 nie zwrócił żadnej wartości tablicy. Nie zwrócił nawet nazwy pola.

Wartości puste i brakujące

Jeśli operand jest pusty lub go brakuje, $last zwraca null .

Załóżmy, że wstawiamy następujący dokument:

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

Uruchommy kod ponownie:

db.players.aggregate([ 
  {
    $project: {
        "lastScore": { 
          $last: "$scores" 
        }
    }
  } 
])

Wynik:

{ "_id" : 1, "lastScore" : 3 }
{ "_id" : 2, "lastScore" : 18 }
{ "_id" : 3, "lastScore" : 8 }
{ "_id" : 4 }
{ "_id" : 5, "lastScore" : null }

Tym razem zwrócił pole o wartości null .

Nieprawidłowy argument

Operand dla $last musi rozwiązać do tablicy, null lub brak. Podanie nieprawidłowego operandu skutkuje błędem.

Aby to zademonstrować, spróbujmy użyć $last przeciwko player pole (które nie jest tablicą):

db.players.aggregate([ 
  {
    $project: {
        "lastPlayer": { 
          $last: "$player" 
        }
    }
  } 
])

Wynik:

Error: command failed: {
	"ok" : 0,
	"errmsg" : "$last'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

Zgodnie z oczekiwaniami, zwrócił błąd.