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.
# $ min
Neu ab Version 8.0.1.
Der `$minN` Operator in Amazon DocumentDB gibt die N kleinsten Werte zurück. Wenn er als Akkumulator in einer `$group` Stufe verwendet wird, gibt er ein Array mit den N Mindestwerten in jeder Gruppe zurück. Wenn er als Array-Ausdrucksoperator verwendet wird, gibt er die N minimalen Elemente eines Arrays zurück.
**Parameter**
+ `input`: Ein Ausdruck, der in das Array oder Feld aufgelöst wird, aus dem die `n` Mindestwerte zurückgegeben werden sollen.
+ `n`: Ein Ausdruck, der in eine positive Ganzzahl aufgelöst wird und angibt, wie viele Mindestwerte zurückgegeben werden sollen.
## Behavior
**Verhalten des Operators „Array-Ausdruck **
+ Sie können keinen Wert von `n` weniger als angeben`1`.
+ `$minN`filtert die im `input` Array gefundenen `null` Werte heraus.
+ Wenn der angegebene `n` Wert größer oder gleich der Anzahl der Elemente im `input` Array ist, werden alle Elemente im `input` Array `$minN` zurückgegeben.
+ Wenn es in einen Wert `input` aufgelöst wird, der kein Array ist, tritt beim Aggregationsvorgang ein Fehler auf.
+ Wenn es sowohl numerische als auch Zeichenkettenelemente `input` enthält, werden die numerischen Elemente gemäß der BSON-Vergleichsreihenfolge vor den Zeichenkettenelementen sortiert.
**Verhalten des Akkumulators **
+ Bei Verwendung als Akkumulator `n` muss es sich um einen positiven Integralausdruck handeln, der entweder eine Konstante ist oder vom `_id` Wert für abhängt. `$group`
+ `$minN`filtert Nullwerte und fehlende Werte heraus.
+ Wenn die Gruppe weniger als `n` Elemente enthält, werden alle Elemente in der Gruppe `$minN` zurückgegeben.
+ `$minN`vergleicht Eingabedaten gemäß der BSON-Vergleichsreihenfolge, um den geeigneten Ausgabetyp zu ermitteln. Wenn die Eingabedaten mehrere Datentypen enthalten, ist der `$minN` Ausgabetyp der niedrigste in der Vergleichsreihenfolge.
**Reihenfolge der Ausgaben **
`$minN`gibt Werte in keiner bestimmten Sortierreihenfolge zurück. Wenn die Garantie einer bestimmten Sortierreihenfolge erforderlich ist, verwenden Sie `$bottomN` stattdessen die Option oder schließen Sie das Ergebnis damit `$sortArray` ein.
## Beispiel (MongoDB Shell)
Das folgende Beispiel zeigt, wie der `$minN` Akkumulator verwendet wird, um die beiden niedrigsten Punktzahlen für jedes Subjekt abzurufen.
**Erstellen Sie Beispieldokumente **
```
db.scores.insertMany([
{ subject: "math", score: 85 },
{ subject: "math", score: 72 },
{ subject: "math", score: 93 },
{ subject: "math", score: 68 },
{ subject: "science", score: 90 },
{ subject: "science", score: 78 },
{ subject: "science", score: 65 },
{ subject: "science", score: 88 }
]);
```
**Beispiel für eine Abfrage **
```
db.scores.aggregate([
{ $group: { _id: "$subject", lowestTwo: { $minN: { input: "$score", n: 2 } } } }
]);
```
**Ausgabe**
```
[
{ "_id": "math", "lowestTwo": [72, 68] },
{ "_id": "science", "lowestTwo": [78, 65] }
]
```
## Beispiel für die Verwendung von Ausdrücken (MongoDB Shell)
Der `$minN` Operator kann auch als Ausdruck innerhalb einer `$project` Stufe verwendet werden, um die N kleinsten Elemente aus einem Array-Feld zurückzugeben.
**Erstellen Sie Beispieldokumente **
```
db.readings.insertMany([
{ _id: 1, sensor: "A", values: [45, 12, 78, 3, 56] },
{ _id: 2, sensor: "B", values: [90, 23, 67, 11, 44] }
]);
```
**Beispiel für eine Abfrage **
```
db.readings.aggregate([
{ $project: {
lowestThree: { $minN: { input: "$values", n: 3 } }
}}
]);
```
**Ausgabe**
```
[
{ "_id": 1, "lowestThree": [45, 12, 3] },
{ "_id": 2, "lowestThree": [44, 23, 11] }
]
```
## Codebeispiele
Um ein Codebeispiel für die Verwendung des `$minN` Operators anzuzeigen, wählen Sie die Registerkarte für die Sprache, die Sie verwenden möchten. Die folgenden Beispiele zeigen sowohl die Verwendung von Akkumulatoren (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://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
try {
await client.connect();
const db = client.db('test');
// Accumulator usage: N smallest values per group
const scores = db.collection('scores');
const accumulatorResult = await scores.aggregate([
{ $group: { _id: "$subject", lowestTwo: { $minN: { input: "$score", n: 2 } } } }
]).toArray();
console.log('Accumulator result:', accumulatorResult);
// Expression usage: N smallest elements from an array field
const readings = db.collection('readings');
const expressionResult = await readings.aggregate([
{ $project: { lowestThree: { $minN: { input: "$values", n: 3 } } } }
]).toArray();
console.log('Expression result:', expressionResult);
} finally {
await client.close();
}
}
example();
```
------
#### [ Python ]
```
from pymongo import MongoClient
def example():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
try:
db = client['test']
# Accumulator usage: N smallest values per group
scores = db['scores']
accumulator_result = list(scores.aggregate([
{ '$group': { '_id': '$subject', 'lowestTwo': { '$minN': { 'input': '$score', 'n': 2 } } } }
]))
print('Accumulator result:', accumulator_result)
# Expression usage: N smallest elements from an array field
readings = db['readings']
expression_result = list(readings.aggregate([
{ '$project': { 'lowestThree': { '$minN': { 'input': '$values', 'n': 3 } } } }
]))
print('Expression result:', expression_result)
finally:
client.close()
example()
```
------