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.

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

L'opérateur de `$max` mise à jour met à jour la valeur d'un champ uniquement si la valeur spécifiée est supérieure à la valeur du champ actuel. Cet opérateur est utile pour maintenir les valeurs maximales entre les mises à jour.

**Paramètres**
+ `field`: champ à mettre à jour.
+ `value`: valeur à comparer avec la valeur actuelle du champ.

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

L'exemple suivant montre comment utiliser l'`$max`opérateur pour mettre à jour le score le plus élevé enregistré pour un joueur.

**Création d'exemples de documents**

```
db.scores.insertMany([
  { _id: 1, player: "Alice", highScore: 85 },
  { _id: 2, player: "Bob", highScore: 92 },
  { _id: 3, player: "Charlie", highScore: 78 }
])
```

**Exemple de mise à jour**

```
db.scores.updateOne(
  { _id: 1 },
  { $max: { highScore: 95 } }
)
```

**Result**

Le `highScore` champ pour Alice est mis à jour à 95 car 95 est supérieur à la valeur actuelle de 85.

```
{ "_id": 1, "player": "Alice", "highScore": 95 }
```

## Exemples de code
<a name="max-update-code"></a>

Pour afficher un exemple de code d'utilisation de la `$max` commande, choisissez l'onglet correspondant à la langue que vous souhaitez utiliser :

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

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

async function example() {
  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 collection = db.collection('scores');

  const result = await collection.updateOne(
    { _id: 1 },
    { $max: { highScore: 95 } }
  );

  console.log(result);
  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')
    db = client['test']
    collection = db['scores']

    result = collection.update_one(
        { '_id': 1 },
        { '$max': { 'highScore': 95 } }
    )

    print(result)
    client.close()

example()
```

------