View a markdown version of this page

$LastN - Amazon DocumentDB
Exemple (MongoDB Shell)Exemple d'utilisation d'expressions (MongoDB Shell)Exemples de code

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

$LastN

Nouveau depuis la version 8.0.1.

L'$lastNopérateur d'Amazon DocumentDB renvoie les N derniers éléments. Lorsqu'il est utilisé comme accumulateur dans une $group étape, il renvoie un tableau des N dernières valeurs de chaque groupe. Lorsqu'il est utilisé comme opérateur d'expression de tableau, il renvoie les N derniers éléments d'un tableau.

Paramètres

  • input: expression qui renvoie au champ ou au tableau à partir duquel les valeurs doivent être renvoyées.

  • n: entier positif qui indique le nombre de valeurs à renvoyer. Lorsqu'il est utilisé comme accumulateur dans une $group étape, il n peut également s'agir d'une expression, à condition qu'elle soit résolue en un entier positif en fonction du _id champ de groupe.

Exemple (MongoDB Shell)

L'exemple suivant montre comment utiliser l'$lastNaccumulateur pour récupérer les deux dernières quantités pour chaque article lors de l'agrégation.

Note

$lastNsélectionne les valeurs dans l'ordre dans lequel les documents arrivent sur $group scène. Pour renvoyer les N dernières valeurs pour un ordre spécifique (par exemple, par date ou score), ajoutez une $sort étape avant$group.

Créez des exemples de documents 

db.sales.insertMany([
  { item: "abc", quantity: 10, date: ISODate("2023-01-01") },
  { item: "abc", quantity: 5, date: ISODate("2023-01-02") },
  { item: "abc", quantity: 8, date: ISODate("2023-01-03") },
  { item: "xyz", quantity: 15, date: ISODate("2023-01-01") },
  { item: "xyz", quantity: 7, date: ISODate("2023-01-02") },
  { item: "xyz", quantity: 3, date: ISODate("2023-01-03") }
]);

Exemple de requête 

db.sales.aggregate([
  { $group: { _id: "$item", lastTwoQuantities: { $lastN: { input: "$quantity", n: 2 } } } }
]);

Sortie

[
  { "_id": "abc", "lastTwoQuantities": [5, 8] },
  { "_id": "xyz", "lastTwoQuantities": [7, 3] }
]

Exemple d'utilisation d'expressions (MongoDB Shell)

L'$lastNopérateur peut également être utilisé comme expression au sein d'une $project étape pour renvoyer les N derniers éléments d'un champ de tableau.

Créez des exemples de documents 

db.inventory.insertMany([
  { _id: 1, item: "abc", tags: ["red", "green", "blue", "yellow", "purple"] },
  { _id: 2, item: "xyz", tags: ["alpha", "beta", "gamma"] }
]);

Exemple de requête 

db.inventory.aggregate([
  { $project: {
      lastThreeTags: { $lastN: { input: "$tags", n: 3 } }
    }}
]);

Sortie

[
  { "_id": 1, "lastThreeTags": ["blue", "yellow", "purple"] },
  { "_id": 2, "lastThreeTags": ["alpha", "beta", "gamma"] }
]

Exemples de code

Pour afficher un exemple de code d'utilisation de l'$lastNaccumulateur, choisissez l'onglet correspondant à la langue que vous souhaitez utiliser. Les exemples suivants montrent à la fois l'utilisation de l'accumulateur (in$group) et l'utilisation de l'expression (in$project) :

Node.js
const { MongoClient } = require('mongodb');

async function example() {
  const client = new MongoClient('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');

  try {
    await client.connect();
    const db = client.db('test');

    // Accumulator usage: last N values per group
    const sales = db.collection('sales');
    const accumulatorResult = await sales.aggregate([
      { $group: { _id: "$item", lastTwoQuantities: { $lastN: { input: "$quantity", n: 2 } } } }
    ]).toArray();
    console.log('Accumulator result:', accumulatorResult);

    // Expression usage: last N elements of an array field
    const inventory = db.collection('inventory');
    const expressionResult = await inventory.aggregate([
      { $project: { lastThreeTags: { $lastN: { input: "$tags", n: 3 } } } }
    ]).toArray();
    console.log('Expression result:', expressionResult);

  } finally {
    await client.close();
  }
}

example();
Python
from pymongo import MongoClient

def example():
    client = MongoClient('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')

    try:
        db = client['test']

        # Accumulator usage: last N values per group
        sales = db['sales']
        accumulator_result = list(sales.aggregate([
            { '$group': { '_id': '$item', 'lastTwoQuantities': { '$lastN': { 'input': '$quantity', 'n': 2 } } } }
        ]))
        print('Accumulator result:', accumulator_result)

        # Expression usage: last N elements of an array field
        inventory = db['inventory']
        expression_result = list(inventory.aggregate([
            { '$project': { 'lastThreeTags': { '$lastN': { 'input': '$tags', 'n': 3 } } } }
        ]))
        print('Expression result:', expression_result)

    finally:
        client.close()

example()