$push - Amazon DocumentDB
Beispiel (MongoDB Shell)Codebeispiele

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

$push

Der $push Operator in Amazon DocumentDB wird verwendet, um ein Element zu einem Array-Feld in einem Dokument hinzuzufügen. Dieser Operator ist besonders nützlich, wenn Sie neue Daten an ein vorhandenes Array anhängen müssen, ohne das gesamte Array zu überschreiben.

Parameter

  • field: Der Name des Array-Feldes, zu dem das neue Element hinzugefügt werden soll.

  • value: Der Wert, der dem Array hinzugefügt werden soll.

  • position: (optional) Ein Modifikator, der die Position im Array angibt, an der das neue Element hinzugefügt werden soll. Zu den unterstützten Modifikatoren gehören $ (am Ende des Arrays hinzufügen) und $[] (am Ende des Arrays hinzufügen, dabei alle Array-Filter ignorieren).

Beispiel (MongoDB Shell)

Das folgende Beispiel zeigt, wie der $push Operator verwendet wird, um einem Array-Feld in einem Dokument neue Elemente hinzuzufügen.

Erstellen Sie Beispieldokumente

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

Beispiel für eine Abfrage

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

Ausgabe

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

Nach dem Ausführen des Updates _id: 1 wird das hobbies Array für das Dokument mit aktualisiert["reading", "swimming", "hiking"].

Codebeispiele

Um ein Codebeispiel für die Verwendung des $push Befehls anzuzeigen, wählen Sie die Registerkarte für die Sprache, die Sie verwenden möchten:

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