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.

# \$1max
<a name="max"></a>

Die `$max` Aggregationsphase wird verwendet, um den Maximalwert eines angegebenen Felds für alle Dokumente in einer Pipeline-Phase zurückzugeben. Dieser Operator ist nützlich, um den höchsten Wert in einer Reihe von Dokumenten zu finden.

**Parameter**
+ `expression`: Der Ausdruck, der zur Berechnung des Maximalwerts verwendet werden soll.

## Beispiel (MongoDB Shell)
<a name="max-examples"></a>

Das folgende Beispiel zeigt, wie der `$max` Operator verwendet wird, um die maximale Punktzahl in einer Sammlung von Studentendokumenten zu ermitteln. `$group`In der Phase werden alle Dokumente gruppiert, und der `$max` Operator wird verwendet, um den Maximalwert des `score` Feldes für alle Dokumente zu berechnen.

**Erstellen Sie Beispieldokumente**

```
db.students.insertMany([
  { name: "John", score: 85 },
  { name: "Jane", score: 92 },
  { name: "Bob", score: 78 },
  { name: "Alice", score: 90 }
])
```

**Beispiel für eine Abfrage**

```
db.students.aggregate([
  { $group: { _id: null, maxScore: { $max: "$score" } } },
  { $project: { _id: 0, maxScore: 1 } }
])
```

**Ausgabe**

```
[ { maxScore: 92 } ]
```

## Codebeispiele
<a name="max-code"></a>

Um ein Codebeispiel für die Verwendung des `$max` Befehls anzuzeigen, wählen Sie die Registerkarte für die Sprache, die Sie verwenden möchten:

------
#### [ Node.js ]

```
const { MongoClient } = require('mongodb');

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

  const result = await students.aggregate([
    { $group: { _id: null, maxScore: { $max: "$score" } } }
  ]).toArray();

  console.log(result);
  await client.close();
}

findMaxScore();
```

------
#### [ Python ]

```
from pymongo import MongoClient

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

    result = list(students.aggregate([
        { "$group": { "_id": None, "maxScore": { "$max": "$score" } } }
    ]))

    print(result)
    client.close()

find_max_score()
```

------