MongoDB updateOne()

In MongoDB der db.collection.updateOne() -Methode aktualisiert ein einzelnes Dokument innerhalb der Sammlung basierend auf dem Filter.

Beispiel

Angenommen, wir haben eine Sammlung namens pets die folgende Dokumente enthält:

{ "_id" : 1, "name" : "Wag", "type" : "Dog" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" }

Wir können ein Dokument wie folgt aktualisieren:

db.pets.updateOne( 
    { type: "Dog" },
    { $set: { type: "Cow" } }
    )

Ergebnis:

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

Dadurch wurde nur ein Dokument aktualisiert, obwohl zwei Dokumente den Filterkriterien entsprechen (die Kriterien sind type: "Dog"). ).

Wir können die Ergebnisse wie folgt überprüfen:

db.pets.find()

Ergebnis:

{ "_id" : 1, "name" : "Wag", "type" : "Cow" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" }

Das erste Dokument hat jetzt einen type von Cow statt Dog , aber das zweite Dokument war nicht betroffen, obwohl es auch den Filterkriterien entsprach.

Nach oben einfügen

Die db.collection.updateOne() -Methode akzeptiert einen upsert Argument, mit dem Sie eine Upsert-Operation ausführen können.

Wenn upsert: true , wird das Dokument aktualisiert, wenn es eine Übereinstimmung mit den Filterkriterien gibt, aber wenn es keine Übereinstimmung gibt, wird ein neues Dokument eingefügt.

Beginnen wir wieder mit den Originaldokumenten:

{ "_id" : 1, "name" : "Wag", "type" : "Dog" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" }

Beispiel:

db.pets.updateOne( 
    { name: "Bubbles" },
    { $set: { type: "Fish" } },
    { upsert: true }
    )

Ergebnis:

{
	"acknowledged" : true,
	"matchedCount" : 0,
	"modifiedCount" : 0,
	"upsertedId" : ObjectId("5fe1e94dd991410169410199")
}

In diesem Fall gab es keine Übereinstimmungen, also wurde ein Dokument eingefügt.

Sehen wir uns die Sammlung an.

db.pets.find()

Ergebnis:

 { "_id" : 1, "name" : "Wag", "type" : "Dog" }
 { "_id" : 2, "name" : "Bark", "type" : "Dog" }
 { "_id" : 3, "name" : "Meow", "type" : "Cat" }
 { "_id" : ObjectId("5fe1e94dd991410169410199"), "name" : "Bubbles", "type" : "Fish" } 

Eingebettete Dokumente

Sie können auch db.collection.updateOne() verwenden um eingebettete Dokumente zu aktualisieren.

Angenommen, wir haben das folgende Dokument:

{
	"_id" : 1,
	"name" : "Wag",
	"type" : "Dog",
	"specs" : {
		"height" : 400,
		"weight" : 15,
		"color" : "brown"
	}
}

Wir können den folgenden Code verwenden, um das eingebettete Dokument zu aktualisieren.

db.pets.updateOne({ 
    _id: 1 
    }, { 
        $set: { 
            "specs.weight": 20, 
            "specs.color": "blue"
        } 
})

Ergebnis:

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

So können wir sehen, dass ein Dokument aktualisiert wurde.

Sehen wir uns das Dokument an.

db.pets.find({
    _id: 1
    }).pretty()

Ergebnis:

{
	"_id" : 1,
	"name" : "Wag",
	"type" : "Dog",
	"specs" : {
		"height" : 400,
		"weight" : 20,
		"color" : "blue"
	}
}

Wir können sehen, dass das eingebettete Dokument wie angegeben aktualisiert wurde.

Arrays

Lassen Sie uns db.collection.updateOne() verwenden um ein Array zu aktualisieren.

Angenommen, wir haben das folgende Dokument:

{
	"_id" : 1,
	"name" : "Wag",
	"type" : "Dog",
	"awards" : [
		"Top Dog",
		"Best Dog",
		"Biggest Dog"
	]
}

Lassen Sie uns zwei der Array-Elemente und den Namen des Hundes aktualisieren.

db.pets.updateOne({ 
    _id: 1 
    }, { 
        $set: { 
            "name": "Bark",
            "awards.0": "Bottom Dog", 
            "awards.1": "Worst Dog"
        } 
})

Ergebnis:

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

Wir können sehen, dass ein Dokument aktualisiert wurde.

Sehen wir uns das Dokument an.

db.pets.find().pretty()

Ergebnis:

{
	"_id" : 1,
	"name" : "Bark",
	"type" : "Dog",
	"awards" : [
		"Bottom Dog",
		"Worst Dog",
		"Biggest Dog"
	]
}

Die arrayFilters Parameter

Sie können auch die arrayFilters verwenden -Parameter und den positionellen $ Operator, um zu bestimmen, welche Array-Elemente aktualisiert werden sollen.

Angenommen, wir haben eine Sammlung namens players mit folgenden Dokumenten:

{ "_id" : 1, "scores" : [ 1, 5, 3 ] }
{ "_id" : 2, "scores" : [ 8, 17, 18 ] }
{ "_id" : 3, "scores" : [ 15, 11, 8 ] }

Wir könnten die folgende Abfrage ausführen, um nur die Array-Elemente zu aktualisieren, deren Wert höher als ein bestimmter Betrag ist (in diesem Fall 10).

db.players.updateOne(
   { scores: { $gte: 10 } },
   { $set: { "scores.$[e]" : 10 } },
   { arrayFilters: [ { "e": { $gte: 10 } } ] }
)

Ergebnis:

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

Wie erwartet wird dadurch nur ein Dokument aktualisiert, obwohl zwei Dokumente den Kriterien entsprechen.

So sehen die Dokumente jetzt aus.

db.players.find()

Ergebnis:

{ "_id" : 1, "scores" : [ 1, 5, 3 ] }
{ "_id" : 2, "scores" : [ 8, 10, 10 ] }
{ "_id" : 3, "scores" : [ 15, 11, 8 ] }

In Dokument 2 wurden zwei Array-Elemente aktualisiert, da diese Elemente den Kriterien entsprachen.

Weitere Informationen

Die db.collection.updateOne() -Methode akzeptiert auch andere Parameter wie writeConcern , collation , und hint .

Siehe die MongoDB-Dokumentation für db.collections.updateOne() für weitere Informationen.