$push - 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.

$push

L'$pushopérateur dans Amazon DocumentDB est utilisé pour ajouter un élément à un champ de tableau dans un document. Cet opérateur est particulièrement utile lorsque vous devez ajouter de nouvelles données à un tableau existant sans remplacer le tableau entier.

Paramètres

  • field: nom du champ du tableau auquel le nouvel élément doit être ajouté.

  • value: valeur à ajouter au tableau.

  • position: (facultatif) Un modificateur qui spécifie la position dans le tableau où le nouvel élément doit être ajouté. Les modificateurs pris en charge incluent $ (ajouter à la fin du tableau) et $[] (ajouter à la fin du tableau, en ignorant les filtres du tableau).

Exemple (MongoDB Shell)

L'exemple suivant montre comment utiliser l'$pushopérateur pour ajouter de nouveaux éléments à un champ de tableau dans un document.

Création d'exemples de documents

db.users.insert([
  { _id: 1, name: "John Doe", hobbies: ["reading", "swimming"] },
  { _id: 2, name: "Jane Smith", hobbies: ["gardening", "cooking"] }
])

Exemple de requête

db.users.updateOne(
  { _id: 1 },
  { $push: { hobbies: "hiking" } }
)

Sortie

{
  "acknowledged" : true,
  "matchedCount" : 1,
  "modifiedCount" : 1
}

Après avoir exécuté la mise à jour, le hobbies tableau du document contenant _id: 1 sera mis à jour en["reading", "swimming", "hiking"].

Exemples de code

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

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

async function updateDocument() {
  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: 1 },
    { $push: { hobbies: "hiking" } }
  );

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

updateDocument();
Python
from pymongo import MongoClient

def update_document():
    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': 1},
        {'$push': {'hobbies': 'hiking'}}
    )

    print(result.raw_result)
    client.close()

update_document()