Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

La etapa de `$max` agregación se utiliza para devolver el valor máximo de un campo específico en todos los documentos de una etapa de canalización. Este operador es útil para encontrar el valor más alto en un conjunto de documentos.

**Parámetros**
+ `expression`: la expresión que se utilizará para calcular el valor máximo.

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

El siguiente ejemplo muestra cómo utilizar el `$max` operador para encontrar la puntuación máxima en una colección de documentos de los estudiantes. La `$group` etapa agrupa todos los documentos y el `$max` operador se utiliza para calcular el valor máximo del `score` campo en todos los documentos.

**Cree documentos de muestra**

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

**Ejemplo de consulta**

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

**Salida**

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

## Ejemplos de código
<a name="max-code"></a>

Para ver un ejemplo de código para usar el `$max` comando, elija la pestaña del idioma que desee usar:

------
#### [ 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()
```

------