문서의 배열 업데이트

이 페이지의 내용

개요

샘플 데이터
배열 요소 지정
첫 번째 배열 요소
다중 배열 요소
모든 배열 요소
추가 정보
API 문서

개요

이 가이드에서는 하나 이상의 문서에서 배열 요소를 업데이트하는 방법을 학습할 수 있습니다.

배열의 요소를 업데이트하려면 다음 작업을 수행하세요.

업데이트를 지정하는 업데이트 문서 를 제공합니다.
업데이트할 배열 요소를 지정합니다.
이러한 사양으로 업데이트 작업을 사용하여 업데이트를 수행합니다.

샘플 데이터

이 가이드의 예제에서는 다음 Drink 구조체를 drinks collection의 문서 모델로 사용합니다.

type Drink struct {
	Description string
	Sizes       []int32 `bson:"sizes,truncate"`
	Styles      []string
}

truncate 구조체 태그를 사용하면 드라이버가 마샬링을 해제할 때 float64와(과) 같은 유형을 int32(으)로 자를 수 있습니다.

이 가이드의 예제를 실행하려면 다음 스니펫을 사용하여 샘플 데이터를 db.drinks collection에 로드하세요.

coll := client.Database("db").Collection("drinks")
docs := []interface{}{
	Drink{Description: "Matcha Latte", Sizes: []int32{12, 16, 20}, Styles: []string{"iced", "hot", "extra hot"}},
}
result, err := coll.InsertMany(context.TODO(), docs)

각 문서에는 각 문서의 description, sizes 및 styles 필드에 해당하는 음료 설명, 음료의 크기(온스), 제조 방식을 비롯한 음료 설명이 포함되어 있습니다.

팁

존재하지 않는 데이터베이스 및 collection

쓰기 작업을 수행할 때 필요한 데이터베이스 및 collection이 없는 경우 서버는 이를 암시적으로 생성합니다.

다음 예제에서는 FindOneAndUpdate() 메서드를 사용하여 문서를 검색 및 업데이트하고 업데이트가 발생한 후의 문서의 상태를 반환합니다. 배열 필드가 있는 여러 문서를 업데이트하려면 UpdateMany() 메서드를 사용하세요.

배열 요소 지정

업데이트할 배열 요소를 지정하려면 위치 연산자를 사용합니다. 위치 연산자는 업데이트할 첫 번째, 여러 개 또는 모든 배열 요소를 지정할 수 있습니다.

위치 연산자를 사용해 배열 요소를 지정할 때는 점 표기법을 사용합니다. 점 표기법은 포함된 문서의 배열 요소와 필드를 탐색하기 위한 속성 액세스 구문입니다.

첫 번째 배열 요소

쿼리 필터와 일치하는 첫 번째 배열 요소를 업데이트하려면 위치 $ 연산자를 사용합니다. 쿼리 필터는 배열 필드에 대한 필터여야 합니다.

예제

이 예에서는 다음 조치를 수행합니다.

값은 16보다 작거나 같은 sizes의 배열 요소와 일치합니다.
2와 일치하는 첫 번째 배열 값을 감소시킵니다.

filter := bson.D{{"sizes", bson.D{{"$lte", 16}}}}
update := bson.D{{"$inc", bson.D{{"sizes.$", -2}}}}
opts := options.FindOneAndUpdate().
    SetReturnDocument(options.After)
var updatedDoc Drink
err := coll.FindOneAndUpdate(context.TODO(), filter, update, opts).Decode(&updatedDoc)
if err != nil {
    panic(err)
}
res, _ := bson.MarshalExtJSON(updatedDoc, false, false)
fmt.Println(string(res))

참고

쿼리 필터는 12 및 16 값과 일치합니다. 연산은 12 와 먼저 일치하므로 감소합니다. 일치하는 두 값을 모두 업데이트하려면 여러 배열 요소 항목을 참조하세요.

다중 배열 요소

쿼리 필터와 일치하는 여러 배열 요소를 업데이트하려면 필터링된 위치 $[<identifier>] 연산자를 사용합니다. 업데이트할 배열 요소를 지정하려면 업데이트 작업에 배열 필터를 포함해야 합니다.

<identifier>는 배열 필터 내에서 사용하는 이름입니다. 이 값은 소문자로 시작해야 하며 영숫자만 포함할 수 있습니다.

예제

이 예에서는 다음 조치를 수행합니다.

'hot'을 포함하는 배열 요소와 일치하도록 hotOptions이라는 식별자를 사용해 배열 필터를 생성합니다.
SetArrayFilters() 메서드를 사용하여 배열 필터를 적용합니다.
이러한 배열 요소를 제거합니다.

identifier := []interface{}{bson.D{{"hotOptions", bson.D{{"$regex", "hot"}}}}}
update := bson.D{{"$unset", bson.D{{"styles.$[hotOptions]", ""}}}}
opts := options.FindOneAndUpdate().
    SetArrayFilters(options.ArrayFilters{Filters: identifier}).
    SetReturnDocument(options.After)
var updatedDoc Drink
err := coll.FindOneAndUpdate(context.TODO(), bson.D{}, update, opts).Decode(&updatedDoc)
if err != nil {
    panic(err)
}
res, _ := bson.MarshalExtJSON(updatedDoc, false, false)
fmt.Println(string(res))

모든 배열 요소

모든 배열 요소를 업데이트하려면 모든 위치 $[] 연산자를 사용하세요.

참고

배열 필드에 쿼리 필터를 지정하면 위치 $[] 연산자는 쿼리 필터를 무시하고 모든 배열 요소를 업데이트합니다.

예제

이 예제에서는 sizes의 모든 배열 요소에 29.57을 곱해 온스를 밀리리터로 변환합니다.

update := bson.D{{"$mul", bson.D{{"sizes.$[]", 29.57}}}}
opts := options.FindOneAndUpdate().
    SetReturnDocument(options.After)
var updatedDoc Drink
err := coll.FindOneAndUpdate(context.TODO(), bson.D{}, update, opts).Decode(&updatedDoc)
if err != nil {
    panic(err)
}
res, _ := bson.MarshalExtJSON(updatedDoc, false, false)
fmt.Println(string(res))

추가 정보

이 가이드에서 설명하는 작업에 대해 자세히 알아보려면 다음 가이드를 참조하세요.

API 문서

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

← 문서 수정

한 번의 작업으로 삽입 또는 업데이트 →