ドキュメントの変更

に関するメモ _id

MongoDB コレクション内の各ドキュメントには、一意かつ不変の_idフィールドがあります。 _idフィールドを変更するには、アップデート操作と置換操作を使用できません。 このフィールドを変更しようとすると、アップデート メソッドと置換メソッドはWriteErrorを返します。

パラメーター

各メソッドは、少なくとも 1 つの更新演算子を含む更新ドキュメントを受け取ります。 更新演算子は、実行する更新のタイプを指定します。 更新ドキュメントには、変更を説明するフィールドと値も含まれます。 更新ドキュメントは、次の形式を使用します。

bson.D{{"<update operator>", bson.D{{"<field>", <value>},
                                    {"<field>", <value>}, ... }},
       {"<update operator>", ... }, ... }

更新演算子と説明を網羅したのリストについては、MongoDB サーバーのマニュアルを参照してください。

Return Values

UpdateOne()、 UpdateByID() 、 UpdateMany()は、操作が成功した場合、更新操作に関する情報を含むUpdateResultタイプを返します。 UpdateResult型には次のプロパティが含まれています。

UpdateOne()に渡されたクエリフィルターに一致するドキュメントが複数ある場合、メソッドは最初に一致したドキュメントを選択してアップデートします。 クエリフィルターに一致するドキュメントがない場合、アップデート操作では変更は行われません。

クエリフィルターに一致するドキュメントがない場合に新しいドキュメントを挿入する方法については、 アップサート ガイドをご覧ください。

{
   "_id" : 2158,
   "name" : "Mary Shelley",
   "department" : "Marketing",
   "role" : "Marketing Analyst",
   "bonus" : 2500,
   ...
}

filter := bson.D{{"_id", 2158}}
update := bson.D{{"$set", bson.D{{"name", "Mary Wollstonecraft Shelley"},
   {"role", "Marketing Director"}}}, {"$inc", bson.D{{"bonus", 2000}}}}
result, err := collection.UpdateOne(context.TODO(), filter, update)
fmt.Printf("Documents matched: %v\n", result.MatchedCount)
fmt.Printf("Documents updated: %v\n", result.ModifiedCount)

{
   "_id" : 2158,
   "name" : "Mary Wollstonecraft Shelley",
   "department" : "Marketing",
   "role" : "Marketing Director",
   "bonus" : 4500,
   ...
}

パラメーター

ReplaceOne() は、既存のドキュメントの代わりに使用するドキュメントである置換ドキュメントを要求しています。 置換ドキュメントは以下の形式を使用します。

bson.D{{"<field>", "<value>"}, {"<field>", "<value>"}, ... }

Return Values

ReplaceOne() は、置換操作が成功した場合、置換操作に関する情報を含むUpdateResult型を返します。 UpdateResult型には次のプロパティが含まれています。

ReplaceOne()に渡されたクエリフィルターに一致するドキュメントが複数ある場合、メソッドは最初に一致したドキュメントを選択して置き換えます。 クエリフィルターに一致するドキュメントがない場合、置換操作は失敗します。

{
   "_id" : 2056,
   "item" : "Mug",
   "brand" : "Simply Ceramics",
   "price" : 2.99,
   "material" : "Glass"
}

filter := bson.D{{"_id", 2056}}
replacement := bson.D{{"item", "Cup"}, {"quantity", 107}}
result, err := collection.ReplaceOne(context.TODO(), filter, replacement)
fmt.Printf("Documents matched: %v\n", result.MatchedCount)
fmt.Printf("Documents replaced: %v\n", result.ModifiedCount)

{
   "_id" : 2056,
   "item" : "Cup",
   "quantity" : 107
}

API ドキュメント

このガイドで説明したメソッドや型の詳細については、次の API ドキュメントを参照してください。

• WriteError

• UpdateOne()

• UpdateByID()

• UpdateMany()

• UpdateResult

• ReplaceOne()