Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
L’opérateur $topN trie les documents sur un ou plusieurs champs spécifiés par la requête et retourne les premiers documents N correspondant aux critères de filtrage. Il étend les fonctionnalités de $top en vous permettant de récupérer plusieurs éléments principaux au lieu d'un seul élément le mieux classé.
Syntaxe
{
$topN: {
output: [listOfFields],
sortBy: {
<fieldName>: < sortOrder >
},
n: < numDocumentsToReturn >
}
}
Paramètres
| Paramètre | Descriptif |
|---|---|
listOfFields |
Liste des champs à renvoyer pour le dernier document du jeu de résultats |
fieldName |
Champ à utiliser pour trier le jeu de résultats |
sortOrder |
1 ou -1. 1 implique le tri dans l’ordre croissant de la valeur du champ, tandis que -1 implique le tri dans l’ordre décroissant des valeurs du champ |
n |
Nombre de documents à retourner en haut du jeu de résultats trié |
Examples
Considérez cet exemple de document de la collection des magasins.
{
"_id": "0fcc0bf0-ed18-4ab8-b558-9848e18058f4",
"name": "First Up Consultants | Beverage Shop - Satterfieldmouth",
"location": {
"lat": -89.2384,
"lon": -46.4012
},
"staff": {
"totalStaff": {
"fullTime": 8,
"partTime": 20
}
},
"sales": {
"totalSales": 75670,
"salesByCategory": [
{
"categoryName": "Wine Accessories",
"totalSales": 34440
},
{
"categoryName": "Bitters",
"totalSales": 39496
},
{
"categoryName": "Rum",
"totalSales": 1734
}
]
},
"promotionEvents": [
{
"eventName": "Unbeatable Bargain Bash",
"promotionalDates": {
"startDate": {
"Year": 2024,
"Month": 6,
"Day": 23
},
"endDate": {
"Year": 2024,
"Month": 7,
"Day": 2
}
},
"discounts": [
{
"categoryName": "Whiskey",
"discountPercentage": 7
},
{
"categoryName": "Bitters",
"discountPercentage": 15
},
{
"categoryName": "Brandy",
"discountPercentage": 8
},
{
"categoryName": "Sports Drinks",
"discountPercentage": 22
},
{
"categoryName": "Vodka",
"discountPercentage": 19
}
]
},
{
"eventName": "Steal of a Deal Days",
"promotionalDates": {
"startDate": {
"Year": 2024,
"Month": 9,
"Day": 21
},
"endDate": {
"Year": 2024,
"Month": 9,
"Day": 29
}
},
"discounts": [
{
"categoryName": "Organic Wine",
"discountPercentage": 19
},
{
"categoryName": "White Wine",
"discountPercentage": 20
},
{
"categoryName": "Sparkling Wine",
"discountPercentage": 19
},
{
"categoryName": "Whiskey",
"discountPercentage": 17
},
{
"categoryName": "Vodka",
"discountPercentage": 23
}
]
}
]
}
Exemple 1 : Obtenir les deux magasins avec les ventes totales les plus faibles
Pour obtenir les deux magasins les plus bas par ventes au sein de la société First Up Consultants, exécutez une requête pour filtrer le nom de la société, trier les documents résultants dans l’ordre croissant des ventes et retourner les deux principaux documents à partir du jeu de résultats trié.
db.stores.aggregate([{
$match: {
company: {
$in: ["First Up Consultants"]
}
}
}, {
$group: {
_id: "$company",
topSales: {
$topN: {
output: ["$company", "$sales"],
sortBy: {
"sales.totalSales": 1
},
n: 2
}
}
}
}])
Cette requête retourne le résultat suivant :
[
{
"_id": "First Up Consultants",
"topSales": [
[
"First Up Consultants",
{
"salesByCategory": [
{
"categoryName": "Towel Sets",
"totalSales": 520
},
{
"categoryName": "Bath Accessories",
"totalSales": 41710
},
{
"categoryName": "Drapes",
"totalSales": 42893
},
{
"categoryName": "Towel Racks",
"totalSales": 30773
},
{
"categoryName": "Hybrid Mattresses",
"totalSales": 39491
},
{
"categoryName": "Innerspring Mattresses",
"totalSales": 6410
},
{
"categoryName": "Bed Frames",
"totalSales": 41917
},
{
"categoryName": "Mattress Protectors",
"totalSales": 44124
},
{
"categoryName": "Bath Towels",
"totalSales": 5671
},
{
"categoryName": "Turkish Towels",
"totalSales": 25674
}
],
"revenue": 279183
}
],
[
"First Up Consultants",
{
"salesByCategory": [
{
"categoryName": "Lavalier Microphones",
"totalSales": 40000
},
{
"categoryName": "Wireless Microphones",
"totalSales": 39691
}
],
"minimumSalesTarget": 30000,
"revenue": 50000
}
]
]
}
]
Exemple 2 : Obtenir les deux événements de promotion les plus récents
Pour trouver les deux événements de promotion les plus récents pour chaque magasin, regroupez les documents dans la collection par magasin, triez-les dans l’ordre croissant des dates de promotion et retournez les deux premiers résultats du jeu de résultats trié par magasin.
db.stores.aggregate([{
$unwind: "$promotionEvents"
},
{
$group: {
_id: "$_id",
storeName: {
$first: "$name"
},
top2RecentPromotions: {
$topN: {
n: 2,
sortBy: {
"promotionEvents.promotionalDates.startDate.Year": -1,
"promotionEvents.promotionalDates.startDate.Month": -1,
"promotionEvents.promotionalDates.startDate.Day": -1
},
output: {
eventName: "$promotionEvents.eventName",
startDate: "$promotionEvents.promotionalDates.startDate"
}
}
}
}
}
])
Les deux premiers résultats retournés par cette requête sont les suivants :
[
{
"_id": "4a99546f-a1d2-4e61-ae9f-b8c7c1faf73c'",
"storeName": "Lakeshore Retail | Stationery Nook - West Van",
"top2RecentPromotions": [
{
"eventName": "Crazy Markdown Madness",
"startDate": {
"Year": 2024,
"Month": 9,
"Day": 21
}
},
{
"eventName": "Flash Sale Fiesta",
"startDate": {
"Year": 2024,
"Month": 6,
"Day": 23
}
}
]
},
{
"_id": "e0c47a06-4fe0-46b7-a309-8971bbb3978f",
"storeName": "VanArsdel, Ltd. | Baby Products Bargains - Elainamouth",
"top2RecentPromotions": [
{
"eventName": "Crazy Deal Days",
"startDate": {
"Year": 2024,
"Month": 9,
"Day": 21
}
}
]
}
]