문서 수정

참고 사항 _id

MongoDB collection의 각 문서에는 고유하고 변경할 수 없는 _id 필드가 있습니다. 업데이트 및 바꾸기 작업을 사용하여 _id 필드를 변경할 수 없습니다. 이 필드를 변경하려고 하면 update 및 replace 메서드가 WriteError를 반환합니다.

매개변수

각 메서드는 하나 이상의 업데이트 연산자 를 포함하는 업데이트 문서 를 사용합니다. 업데이트 연산자는 수행할 업데이트 유형을 지정합니다. 업데이트 문서에는 변경 사항을 설명하는 필드와 값도 포함되어 있습니다. 업데이트 문서는 다음과 같은 포맷을 사용합니다.

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)

Documents matched: 1
Documents updated: 1

{
   "_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)

Documents matched: 1
Documents replaced: 1

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

API 문서

이 가이드에서 설명하는 메서드나 유형에 대해 자세히 알아보려면 다음 API 설명서를 참조하세요.

• WriteError

• UpdateOne()

• UpdateByID()

• UpdateMany()

• UpdateResult

• ReplaceOne()