V MongoDB, $avg operátor agregačního kanálu vypočítá a vrátí průměrnou hodnotu zadaných číselných hodnot.
Syntaxe
$avg operátor podporuje dvě syntaxe.
Syntaxe 1:
{ $avg: <expression> } Syntaxe 2:
{ $avg: [ <expression1>, <expression2> ... ] } První syntaxe přijímá jeden argument a druhá syntaxe přijímá více argumentů.
Při použití ve $group fázi, můžete použít pouze první syntaxi. V tomto případě $avg vrátí společný průměr všech číselných hodnot, které jsou výsledkem použití zadaného výrazu na každý dokument ve skupině dokumentů, které sdílejí stejnou skupinu podle klíče.
Příklady syntaxe 1 (jediný argument)
Zde je několik příkladů, které používají syntaxi 1.
Skupinové dokumenty
Tento příklad používá $avg ve spojení s $group vrátit průměr ze skupiny dokumentů, které jsou seskupeny podle klíče.
Předpokládejme, že máme sbírku nazvanou pets s následujícími dokumenty:
{ "_id" :1, "name" :"Wag", "type" :"Pes", "weight" :20 }{ "_id" :2, "name" :"Bark", "type" :"Pes", "váha" :10 }{ "_id" :3, "jméno" :"Mňau", "typ" :"Kočka", "váha" :7 }{ "_id" :4, "jméno" :"Scratch", "type" :"Kočka", "váha" :8 }{ "_id" :5, "name" :"Bruce", "type" :"Klokánek", "váha" :100 }{ " _id" :6, "name" :"Hop", "type" :"Klokánek", "váha" :130 }{ "_id" :7, "name" :"Punch", "type" :"Klokánek", "váha" :200 }{ "_id" :8, "jméno" :"Snap", "type" :"Kočka", "váha" :12 }{ "_id" :9, "jméno" :"Ruff", "type" :"Pes", "hmotnost" :30 }
Tyto dokumenty můžeme seskupit podle jejich type a poté použijte $avg vrátíte průměrnou váhu každé skupiny:
db.pets.aggregate(
[
{
$group:
{
_id: "$type",
average_weight: { $avg: "$weight" }
}
}
]
) Výsledek:
{ "_id" :"Pes", "průměrná_váha" :20 }{ "_id" :"Kočka", "průměrná_váha" :9 }{ "_id" :"Klokánek", "průměrná_váha" :143,33333333333334 } Pole
Tento příklad platí $avg do jednoho dokumentu, který obsahuje pole s polem hodnot.
Tato možnost je dostupná pouze při použití syntaxe jednoho argumentu. Při použití víceargumentové syntaxe jsou pole ignorována (více o tom níže).
Předpokládejme, že máme kolekci nazvanou players s následujícími dokumenty:
{ "_id" :1, "player" :"Homer", "skóre" :[ 1, 7, 2, 3, 8, 7, 1 ] }{ "_id" :2, "player" :" Marge", "skóre" :[ 0, 1, 8, 17, 18, 8 ] }{ "_id" :3, "hráč" :"Bart", "skóre" :[ 15, 11, 8, 0, 1 , 3 ] }{ "_id" :4, "hráč" :"Brian", "skóre" :[ 7 ] }{ "_id" :5, "hráč" :"Farnsworth", "skóre" :[ ] }{ "_id" :6, "player" :"Meg", "scores" :null }{ "_id" :7, "player" :"Ron" }
Můžeme použít $avg do scores pole v každém dokumentu:
db.players.aggregate(
[
{
$project:
{
player: 1,
averageScore: { $avg: "$scores" }
}
}
]
)
Výsledek:
{ "_id" :1, "player" :"Homer", "averageScore" :4,142857142857143 }{ "_id" :2, "player" :"Marge", "averageScore" :8,66666666666666 3, "player" :"Bart", "averageScore" :6,333333333333333 }{ "_id" :4, "player" :"Brian", "averageScore" :7 }{ "_id" :5, "player" :"Farnsworth ", "averageScore" :null }{ "_id" :6, "player" :"Meg", "averageScore" :null }{ "_id" :7, "player" :"Ron", "averageScore" :null }
V tomto případě první čtyři dokumenty vrátily průměr různých čísel, která byla v příslušných polích.
V případě dokumentu 4 to bylo stejné jako číslo, protože v poli bylo pouze jedno číslo.
Dokument 5 vrátil null protože jsme poskytli prázdné pole.
Dokument 6 vrátil null protože jsme poskytli null jako argument.
Dokument 7 vrátil null protože pole ani neexistovalo.
Příklad syntaxe 2 (více argumentů)
Druhá syntaxe zahrnuje poskytnutí $avg s více než jedním argumentem. $avg pak vypočítá průměr na základě všech dodaných argumentů.
Předpokládejme, že máme kolekci nazvanou data s následujícími dokumenty:
{ "_id" :1, "a" :1, "b" :2, "c" :3, "d" :4 }{ "_id" :2, "a" :1, "b" :2, "c" :3, "d" :[ 4 ] }{ "_id" :3, "a" :1, "b" :2, "c" :3, "d" :"Ahoj" } { "_id" :4, "a" :"Jedna", "b" :"Dva", "c" :"Tři", "d" :"Čtyři" }
Můžeme použít $avg vrátí průměr a , b , c a d pole každého dokumentu:
db.data.aggregate(
[
{
$project:
{
avg: { $avg: [ "$a", "$b", "$c", "$d" ] }
}
}
]
)
Výsledek:
{ "_id" :1, "avg" :2,5 }{ "_id" :2, "avg" :2 }{ "_id" :3, "avg" :2 }{ "_id" :4, " avg" :null }
Dokument 1 vrací průměr vstupních hodnot 1 , 2 , 3 a 4 .
Následující dva dokumenty však vrátily pouze průměr vstupních hodnot 1 , 2 a 3 . $avg operátor ignoroval jejich d pole.
Důvodem je $avg ignoruje nečíselné hodnoty. Takže v tomto případě ignoroval "Hey" v dokumentu 3 a vypočítal průměr ze zbývajících (číselných) polí.
Pokud jde o dokument 2, jeho d pole obsahuje pole. Jak již bylo zmíněno, $avg Při použití víceargumentové syntaxe operátor ignoruje pole. Přesněji řečeno, při použití v tomto kontextu považuje pole za nečíselné hodnoty a $avg ignoruje nečíselné hodnoty.
Pokud jsou všechny hodnoty nečíselné, pak $avg vrátí null . Můžeme to vidět v dokumentu 4.
Chybějící pole
Při použití víceargumentové syntaxe $avg ignoruje všechna chybějící pole. To znamená, že pokud zadáte pole, které neexistuje, bude je ignorovat. Pokud žádné z polí neexistuje, vrátí null .
Příklad:
db.data.aggregate(
[
{
$project:
{
avg: { $avg: [ "$a", "$b", "$c", "$d", "$e" ] }
}
}
]
)
Výsledek:
{ "_id" :1, "avg" :2,5 }{ "_id" :2, "avg" :2 }{ "_id" :3, "avg" :2 }{ "_id" :4, " avg" :null }
V tomto případě jsem poskytl další pole ($e ), který v dokumentech neexistuje. $avg vypočítal průměr na základě zbývajících polí, která dělají existovat.
Co se však stane, když žádné z polí existují:
db.data.aggregate(
[
{
$project:
{
result: { $avg: [ "$x", "$y", "$z" ] }
}
}
]
)
Výsledek:
{ "_id" :1, "result" :null }{ "_id" :2, "result" :null }{ "_id" :3, "result" :null }{ "_id" :4, " výsledek" :null }
Výsledek je null pro všechny dokumenty.
Jak jsme viděli dříve, při použití syntaxe s jedním argumentem vede chybějící pole k null .
Příklad:
db.pets.aggregate(
[
{
$group:
{
_id: "$type",
avg: { $avg: "$oops!" }
}
}
]
)
Výsledek:
{ "_id" :"Klokánek", "avg" :null }{ "_id" :"Kočka", "avg" :null }{ "_id" :"Pes", "avg" :null } Dostupné fáze
$avg je k dispozici v následujících fázích:
$group$project$addFields$set$replaceRoot$replaceWith$matchfázi, která obsahuje$exprvýraz