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.

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

L'`$push`opé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)
<a name="push-examples"></a>

L'exemple suivant montre comment utiliser l'`$push`opé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`[&quot;reading&quot;, &quot;swimming&quot;, &quot;hiking&quot;]`.

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

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

------