View a markdown version of this page

$FirstN - Amazon DocumentDB
Beispiel (MongoDB Shell)Beispiel für die Verwendung von Ausdrücken (MongoDB Shell)Codebeispiele

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

$FirstN

Neu ab Version 8.0.1.

Der $firstN Operator in Amazon DocumentDB gibt die ersten N Elemente zurück. Wenn er als Akkumulator in einer $group Stufe verwendet wird, gibt er ein Array der ersten N Werte in jeder Gruppe zurück. Wenn er als Array-Ausdrucksoperator verwendet wird, gibt er die ersten N Elemente eines Arrays zurück.

Parameter

  • input: Der Ausdruck, der in das Feld oder Array aufgelöst wird, aus dem Werte zurückgegeben werden sollen.

  • n: Eine positive Ganzzahl, die angibt, wie viele Werte zurückgegeben werden sollen. Bei Verwendung als Akkumulator in einer $group Phase n kann es sich auch um einen Ausdruck handeln, sofern er auf der Grundlage des _id Gruppenfeldes in eine positive Ganzzahl aufgelöst wird.

Beispiel (MongoDB Shell)

Das folgende Beispiel zeigt, wie der $firstN Akkumulator verwendet wird, um die ersten beiden Mengen für jedes Element während der Aggregation abzurufen.

Anmerkung

$firstNwählt Werte in der Reihenfolge aus, in der Dokumente die $group Bühne erreichen. Um die ersten N Werte für eine bestimmte Reihenfolge zurückzugeben (z. B. nach Datum oder Punktzahl), fügen Sie eine $sort Stufe davor hinzu$group.

Erstellen Sie Beispieldokumente 

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") }
]);

Beispiel für eine Abfrage 

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

Ausgabe

[
  { "_id": "abc", "firstTwoQuantities": [10, 5] },
  { "_id": "xyz", "firstTwoQuantities": [15, 7] }
]

Beispiel für die Verwendung von Ausdrücken (MongoDB Shell)

Der $firstN Operator kann auch als Ausdruck innerhalb einer $project Stufe verwendet werden, um die ersten N Elemente eines Array-Feldes zurückzugeben.

Erstellen Sie Beispieldokumente 

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

Beispiel für eine Abfrage 

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

Ausgabe

[
  { "_id": 1, "firstThreeTags": ["red", "green", "blue"] },
  { "_id": 2, "firstThreeTags": ["alpha", "beta", "gamma"] }
]

Codebeispiele

Um ein Codebeispiel für die Verwendung des $firstN Akkumulators anzuzeigen, wählen Sie die Registerkarte für die Sprache, die Sie verwenden möchten. Die folgenden Beispiele zeigen sowohl die Verwendung des Akkumulators (in$group) als auch die Verwendung von Ausdrücken (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: first N values per group
    const sales = db.collection('sales');
    const accumulatorResult = await sales.aggregate([
      { $group: { _id: "$item", firstTwoQuantities: { $firstN: { input: "$quantity", n: 2 } } } }
    ]).toArray();
    console.log('Accumulator result:', accumulatorResult);

    // Expression usage: first N elements of an array field
    const inventory = db.collection('inventory');
    const expressionResult = await inventory.aggregate([
      { $project: { firstThreeTags: { $firstN: { 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: first N values per group
        sales = db['sales']
        accumulator_result = list(sales.aggregate([
            { '$group': { '_id': '$item', 'firstTwoQuantities': { '$firstN': { 'input': '$quantity', 'n': 2 } } } }
        ]))
        print('Accumulator result:', accumulator_result)

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

    finally:
        client.close()

example()