$inc - Amazon DocumentDB
Exemple (MongoDB Shell)Exemples de code

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.

$inc

L'$incopérateur est utilisé pour incrémenter la valeur d'un champ d'un montant spécifié. Il est utilisé pour mettre à jour un champ numérique, tel qu'un compteur ou une évaluation, sans avoir à récupérer la valeur actuelle, à calculer la nouvelle valeur, puis à mettre à jour le champ.

Paramètres

  • field: nom du champ à incrémenter.

  • amount: montant par lequel le champ doit être incrémenté. Il peut s'agir d'une valeur positive ou négative.

Exemple (MongoDB Shell)

L'exemple suivant montre comment utiliser l'$incopérateur pour incrémenter le age champ d'un document.

Création d'exemples de documents

db.users.insertOne({_id: 123, name: "John Doe", age: 30})

Exemple de requête

db.users.updateOne({_id: 123}, {$inc: {age: 1}})

Afficher le document mis à jour

db.users.findOne({_id: 123})

Sortie

{ "_id" : 123, "name" : "John Doe", "age" : 31 }

Exemples de code

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

Node.js
const { MongoClient } = require('mongodb');

async function updateWithInc() {
  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('users');

  const result = await collection.updateOne(
    { _id: 123 },
    { $inc: { age: 1 } }
  );

  console.log(result);

  await client.close();
}

updateWithInc();
Python
from pymongo import MongoClient

def update_with_inc():
    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['users']

    result = collection.update_one(
        {'_id': 123},
        {'$inc': {'age': 1}}
    )

    print(result.modified_count)

    client.close()

update_with_inc()