W MongoDB $max Operator potoku agregacji zwraca maksymalną wartość z wyrażenia.
Składnia
$max operator obsługuje dwie składnie.
Składnia 1:
{ $max: <expression> }Składnia 2:
{ $max: [ <expression1>, <expression2> ... ] }Pierwsza składnia akceptuje jeden argument, a druga – wiele argumentów.
W przypadku użycia w grupie $group etapie, możesz użyć tylko pierwszej składni. W tym przypadku $max zwraca maksymalną wartość wynikającą z zastosowania wyrażenia do każdego dokumentu w grupie dokumentów, które współdzielą tę samą grupę według klucza.
Przykłady składni 1 (pojedynczy argument)
Oto kilka przykładów, w których zastosowano składnię jednoargumentową.
Dokumenty zgrupowane
W tym przykładzie użyto $max w połączeniu z $group aby zwrócić maksymalną wartość z grupy dokumentów pogrupowanych według klucza.
Załóżmy, że mamy kolekcję o nazwie pets z następującymi dokumentami:
{ "_id" : 1, "name" : "Wag", "type" : "Dog", "weight" : 20 }
{ "_id" : 2, "name" : "Bark", "type" : "Dog", "weight" : 10 }
{ "_id" : 3, "name" : "Meow", "type" : "Cat", "weight" : 7 }
{ "_id" : 4, "name" : "Scratch", "type" : "Cat", "weight" : 8 }
{ "_id" : 5, "name" : "Bruce", "type" : "Kangaroo", "weight" : 100 }
{ "_id" : 6, "name" : "Hop", "type" : "Kangaroo", "weight" : 130 }
{ "_id" : 7, "name" : "Punch", "type" : "Kangaroo", "weight" : 200 }
{ "_id" : 8, "name" : "Snap", "type" : "Cat", "weight" : 12 }
{ "_id" : 9, "name" : "Ruff", "type" : "Dog", "weight" : 30 }
Możemy pogrupować te dokumenty według ich type pole, a następnie użyj $max aby zwrócić maksymalną wartość weight pole dla każdej grupy:
db.pets.aggregate(
[
{
$group:
{
_id: "$type",
max: { $max: "$weight" }
}
}
]
)Wynik:
{ "_id" : "Kangaroo", "max" : 200 }
{ "_id" : "Cat", "max" : 12 }
{ "_id" : "Dog", "max" : 30 } Tablice
Ten przykład dotyczy $max do pojedynczego dokumentu, który zawiera pole z tablicą wartości.
Ta opcja jest dostępna tylko w przypadku używania składni jednoargumentowej. Tablice są ignorowane podczas używania składni wieloargumentowej (więcej na ten temat poniżej).
Załóżmy, że mamy kolekcję o nazwie players z następującymi dokumentami:
{ "_id" : 1, "player" : "Homer", "scores" : [ 1, 7, 2, 3, 8, 7, 1 ] }
{ "_id" : 2, "player" : "Marge", "scores" : [ 0, 1, 8, 17, 18, 8 ] }
{ "_id" : 3, "player" : "Bart", "scores" : [ 15, 11, 8, 0, 1, 3 ] }
{ "_id" : 4, "player" : "Brian", "scores" : [ 7 ] }
{ "_id" : 5, "player" : "Farnsworth", "scores" : [ ] }
{ "_id" : 6, "player" : "Meg", "scores" : null }
{ "_id" : 7, "player" : "Ron" }
Możemy zastosować $max do scores pole w każdym dokumencie:
db.players.aggregate(
[
{
$project:
{
player: 1,
max: { $max: "$scores" }
}
}
]
)Wynik:
{ "_id" : 1, "player" : "Homer", "max" : 8 }
{ "_id" : 2, "player" : "Marge", "max" : 18 }
{ "_id" : 3, "player" : "Bart", "max" : 15 }
{ "_id" : 4, "player" : "Brian", "max" : 7 }
{ "_id" : 5, "player" : "Farnsworth", "max" : null }
{ "_id" : 6, "player" : "Meg", "max" : null }
{ "_id" : 7, "player" : "Ron", "max" : null } W tym przypadku pierwsze cztery dokumenty zwróciły maksymalną wartość z różnych liczb, które znajdowały się w ich odpowiednich tablicach.
W przypadku dokumentu 4 było to to samo co liczba, ponieważ w tablicy była tylko jedna liczba.
Dokument 5 zwrócił null ponieważ dostarczyliśmy pustą tablicę.
Dokument 6 zwrócił null ponieważ podaliśmy null jako argument.
Dokument 7 zwrócił null ponieważ pole nawet nie istniało.
Przykład składni 2 (wiele argumentów)
Druga składnia obejmuje podanie $max z więcej niż jednym argumentem. $max następnie zwraca maksymalną wartość ze wszystkich dostarczonych argumentów.
Załóżmy, że mamy kolekcję o nazwie data z następującym dokumentem:
{ "_id" : 1, "a" : 10, "b" : 500, "c" : -900, "d" : 4 }
Możemy użyć $max aby zwrócić maksymalną wartość z a , b , c i d pola:
db.data.aggregate(
[
{ $match: { _id: { $in: [ 1 ] } } },
{
$project:
{
max: { $max: [ "$a", "$b", "$c", "$d" ] }
}
}
]
)Wynik:
{ "_id" : 1, "max" : 500 }
W tym przypadku 500 była maksymalną wartością.
Brakujące pola
Używając składni wieloargumentowej, $max ignoruje brakujące pola. Oznacza to, że jeśli podasz pole, które nie istnieje, ignoruje je. Jeśli żadne z pól nie istnieje, zwraca null .
Przykład:
db.data.aggregate(
[
{ $match: { _id: { $in: [ 1 ] } } },
{
$project:
{
max: { $max: [ "$a", "$b", "$c", "$d", "$e" ] }
}
}
]
)Wynik:
{ "_id" : 1, "max" : 500 }
W tym przypadku dodałem dodatkowe pole ($e ), który nie istnieje w dokumencie. $max obliczył maksymalną wartość na podstawie pozostałych pól, które wykonaj istnieje.
Oto jednak, co się dzieje, gdy brak z pól istnieje:
db.data.aggregate(
[
{ $match: { _id: { $in: [ 1 ] } } },
{
$project:
{
result: { $max: [ "$x", "$y", "$z" ] }
}
}
]
)Wynik:
{ "_id" : 1, "result" : null }
Wynik to null .
Jak widzieliśmy wcześniej, podczas korzystania ze składni jednoargumentowej brakujące pole daje w wyniku null .
Przykład:
db.pets.aggregate(
[
{
$group:
{
_id: "$type",
max: { $max: "$oops!" }
}
}
]
)Wynik:
{ "_id" : "Dog", "max" : null }
{ "_id" : "Kangaroo", "max" : null }
{ "_id" : "Cat", "max" : null } Porównywanie różnych typów
$max operator porównuje zarówno wartość, jak i typ. Gdy wartości są różnych typów, $max oblicza maksymalną wartość na podstawie kolejności porównania BSON.
Załóżmy, że nasza kolekcja zawiera następujące dokumenty:
{ "_id" : 2, "a" : 1, "b" : 2, "c" : 3, "d" : [ 1 ] }
{ "_id" : 3, "a" : 1, "b" : 2, "c" : 3, "d" : "1" }
{ "_id" : 4, "a" : "One", "b" : "Two", "c" : "Three", "d" : "Four" }
{
"_id" : 5,
"a" : ISODate("1999-01-03T23:30:15.100Z"),
"b" : ISODate("2000-01-03T23:30:15.100Z")
}
{
"_id" : 6,
"a" : ISODate("1999-01-03T23:30:15.100Z"),
"b" : "2000-01-03T23:30:15.100Z"
}
Z wyjątkiem dokumentu 4, każdy z tych dokumentów używa typów mieszanych (istnieje co najmniej jeden typ, który różni się od pozostałych w polach danych). Dokument 4 używa ciągów znaków we wszystkich czterech polach.
Oto, co się dzieje, gdy zastosujemy $max do tych dokumentów:
db.data.aggregate(
[
{ $match: { _id: { $in: [ 2, 3, 4, 5, 6 ] } } },
{
$project:
{
max: { $max: [ "$a", "$b", "$c", "$d" ] }
}
}
]
)Wynik:
{ "_id" : 2, "max" : [ 1 ] }
{ "_id" : 3, "max" : "1" }
{ "_id" : 4, "max" : "Two" }
{ "_id" : 5, "max" : ISODate("2000-01-03T23:30:15.100Z") }
{ "_id" : 6, "max" : ISODate("1999-01-03T23:30:15.100Z") }
dokument z _id z 2 , tablice są większe niż liczby, więc tablica jest zwracana (nawet jeśli jej elementem jest liczba mniejsza niż niektóre inne liczby).
Dokument 3:Ciągi są większe niż liczby, więc ciąg jest zwracany.
Dokument 4:Wszystkie pola są ciągami, więc Two jest największym ciągiem.
Dokument 5:Podano dwie daty, więc zwracana jest późniejsza data.
Dokument 6:W tym przypadku dostarczany jest obiekt Date i ciąg daty. Obiekty Date są większe niż ciągi, dlatego zwracany jest obiekt Date (nawet jeśli jego data jest wcześniejsza niż ciąg).
Dostępne etapy
$max jest dostępny w następujących etapach:
$group$project$addFields$set$replaceRoot$replaceWith$matchetap zawierający$exprwyrażenie
