CRUD 작업 구성

쓰기 고려

쓰기 고려 (write concern) 작업이 성공적인 으로 반환되기 전에 삽입 또는 업데이트 와 같은 쓰기 (write) 작업을 승인해야 하는 복제본 세트 의 데이터 보유 노드 수를 설명합니다. 기본값 으로 쓰기 (write) 작업은 프라이머리 복제본 세트 구성원만 승인한 경우에 성공적인 .

uri := "mongodb://<hostname>:<port>"
journal := false
cliWC := &writeconcern.WriteConcern{
    W: 2,
    Journal: &journal,
}
clOpts := options.Client().ApplyURI(uri).SetWriteConcern(cliWC)
client, err := mongo.Connect(clOpts)
...
collWC := writeconcern.Majority()
collOpts := options.Collection().SetWriteConcern(collWC)
coll := client.Database("db").Collection("myColl", collOpts)

readConcern

사용자는 읽기 고려 (read concern) 옵션을 통해 클라이언트가 쿼리에서 반환하는 데이터를 결정할 수 있습니다. 기본 읽기 고려 (read concern) 수준은 "local"인데, 클라이언트가 최신 인스턴스 데이터를 반환하며 데이터가 복제본 세트 노드의 대부분에 쓰였다는 보장은 없다는 의미입니다.

rc := readconcern.Majority()
opts := options.Collection().SetReadConcern(rc)
database := client.Database("db")
coll := database.Collection("myCollection", opts)

읽기 설정

읽기 설정 (read preference) 옵션은 MongoDB 클라이언트가 읽기 작업을 복제본 세트의 노드로 라우팅하는 방법을 지정합니다. 애플리케이션은 기본값으로 복제본 세트의 프라이머리 노드에 읽기 작업을 지시합니다.

읽기 설정은 읽기 설정 모드와 선택적으로 태그 세트 목록, maxStalenessSeconds 옵션 및 헤지된 읽기( hedged read ) 옵션으로 구성됩니다.

rp := readpref.Secondary()
opts := options.Database().SetReadPreference(rp)
database := client.Database("db", opts)

데이터 정렬 지정

데이터 정렬을 지정하려면 Collation 객체 만듭니다. Collation 객체 의 Locale 필드 정의해야 하지만 다른 모든 필드는 선택 사항입니다. 예시 들어, 다음 코드 예시 "en_US" 국가 및 언어 설정 설정 데이터 정렬을 사용하여 Collation 객체 지정합니다.

myCollation := &options.Collation{Locale: "en_US"}

객체 필드의 전체 목록은 데이터 정렬 Collation API 문서 를 참조하세요. . 지원되는 모든 국가 및 언어 설정과 Locale 필드의 기본값을 보려면 지원되는 언어 및 국가 및 언어 설정을 방문하세요.

collection 또는 뷰에서 데이터 정렬 설정

새 컬렉션 또는 뷰를 만들 때 데이터 정렬을 적용할 수 있습니다. 이는 해당 컬렉션 또는 뷰에서 호출되는 모든 작업에 대한 기본 데이터 정렬을 정의합니다. CreateCollectionOptions 또는 CreateViewOptions 객체를 통해 데이터 정렬을 설정합니다. 그런 다음 옵션 객체를 인수로 사용하여 CreateCollection() 또는 CreateView() 메서드를 호출합니다.

myCollation := &options.Collation{Locale: "fr", Strength: 1}
opts := options.CreateCollection().SetCollation(myCollation)
err := db.CreateCollection(context.TODO(), "books", opts)
if err != nil {
   panic(err)
}

기본 데이터 정렬 예제 사용

books 컬렉션에서 데이터 정렬을 사용하는 작업을 호출하는 경우 작업은 컬렉션 만들기 예제에 지정된 기본 데이터 정렬을 사용합니다.

books 컬렉션에 다음 문서가 포함되어 있다고 가정합니다.

{"name" : "Emma", "length" : "474"}
{"name" : "Les Misérables", "length": "1462"}
{"name" : "Infinite Jest", "length" : "1104"}
{"name" : "Cryptonomicon", "length" : "918"}
{"name" : "Ça", "length" : "1138"}

다음 예제에서는 Find() 메서드를 사용하여 알파벳순으로 "Infinite Jest" name 값이 있는 모든 문서를 반환합니다.

filter := bson.D{{"name", bson.D{{"$lt", "Infinite Jest"}}}}
cursor, err := coll.Find(context.TODO(), filter)
if err != nil {
   panic(err)
}
var results []bson.D
if err = cursor.All(context.TODO(), &results); err != nil {
   panic(err)
}
for _, result := range results {
   res, _ := bson.MarshalExtJSON(result, false, false)
   fmt.Println(string(res))
}

{"name":"Emma","length":"474"}
{"name":"Cryptonomicon","length":"918"}
{"name":"Ça","length":"1138"}

코드에 기본값 books 데이터 정렬을 지정하지 않으면 Find() 메서드는 기본값 바이너리 데이터 정렬 규칙에 따라 "Infinite Jest" 앞에 오는 name 값을 결정합니다. 이 규칙은 "I"로 시작하는 단어 뒤에 "Ç"로 시작하는 단어를 배치합니다. 출력은 다음과 유사합니다.

{"name":"Emma","length":"474"}
{"name":"Cryptonomicon","length":"918"}

메서드에 대해 Find() 자세히 학습 문서 찾기를 참조하세요.

인덱스에 데이터 정렬 설정

컬렉션에 새 인덱스를 만들 때 데이터 정렬을 적용할 수 있습니다. 인덱스는 컬렉션에 문서의 순서가 지정된 표현을 저장하므로 MongoDB 인스턴스는 메모리 내 정렬 작업에 대한 순서를 수행하지 않습니다.

작업에서 인덱스를 사용하려면 작업에서 인덱스에 지정된 데이터 정렬과 동일한 데이터 정렬을 사용해야 합니다. 또한 작업이 데이터 정렬이 포함된 인덱스에 포함되는지 확인합니다. IndexOptions 객체를 통해 데이터 정렬을 설정하고 이 객체를 CreateOne() 메서드에 인수로 전달합니다.

 myCollation := &options.Collation{Locale: "en_US"}
 opts := options.Index().SetCollation(myCollation)
 indexModel := mongo.IndexModel{
   Keys:    bson.D{{"name", 1}},
   Options: opts,
 }
 name, err := coll.Indexes().CreateOne(context.TODO(), indexModel)
 if err != nil {
   panic(err)
 }
 fmt.Println("Name of Index Created: " + name)

 Name of Index Created: name_1

작업에 데이터 정렬 설정

컬렉션에서 문서를 읽고, 업데이트하고, 삭제하는 작업에는 데이터 정렬을 사용할 수 있습니다. 작업에 데이터 정렬을 적용하면 이전에 컬렉션에 대해 정의된 기본 데이터 정렬이 재정의됩니다.

인덱스의 데이터 정렬과 다른 작업에 새 데이터 정렬을 적용하는 경우 해당 인덱스를 사용할 수 없습니다. 결과적으로 작업이 인덱스에 포함되는 작업만큼 제대로 수행되지 않을 수 있습니다. 인덱스에 포함되지 않는 정렬 작업의 단점에 대한 자세한 내용은 인덱스를 사용하여 쿼리 결과 정렬을 참조하세요. 데이터 정렬을 지원하는 작업 목록은 MongoDB 매뉴얼 을 참조하세요.

filter := bson.D{{"length", bson.D{{"$gt", "1000"}}}}
myCollation := &options.Collation{Locale: "en_US", NumericOrdering: true}
opts := options.Find().SetCollation(myCollation)
cursor, err := coll.Find(context.TODO(), filter, opts)
if err != nil {
   panic(err)
}
var results []bson.D
if err = cursor.All(context.TODO(), &results); err != nil {
   panic(err)
}
for _, result := range results {
   res, _ := bson.MarshalExtJSON(result, false, false)
   fmt.Println(string(res))
}

{"name":"Les Misérables","length":"1462"}
{"name":"Infinite Jest","length":"1104"}
{"name":"Ça","length":"1138"}

{"name":"Emma","length":"474"}
{"name":"Les Misérables","length":"1462"}
{""name":"Infinite Jest","length":"1104"}
{"name":"Cryptonomicon","length":"918"}
{"name":"Ça","length":"1138"}

API 문서

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

• writeConcern

• readConcern

• ReadPref

• 데이터 정렬

• CreateCollectionOptions

• IndexModel

• CreateOne()

• 인덱스 옵션

• UpdateOneOptions

• UpdateManyOptions