데이터 정렬.

예시용 샘플 데이터

이 페이지의 예시에서는 다음 문서와 함께 MongoDB 컬렉션을 사용합니다.

{ "_id" : 1, "firstName" : "Klara" }
{ "_id" : 2, "firstName" : "Gunter" }
{ "_id" : 3, "firstName" : "Günter" }
{ "_id" : 4, "firstName" : "Jürgen" }
{ "_id" : 5, "firstName" : "Hannah" }

이러한 문서는 다음 데이터 클래스로 표시됩니다.

data class FirstName(
    @BsonId val id: Int, 
    val firstName: String, 
    val verified: Boolean = false
)

컬렉션

collection을 생성할 때 기본 데이터 정렬을 설정할 수 있습니다. 지정된 데이터 정렬을 사용하여 collection을 생성하는 경우 해당 collection을 스캔하는 지원되는 모든 작업은 데이터 정렬 규칙을 적용합니다.

해당 컬렉션을 생성할 때만 컬렉션에 기본 데이터 정렬을 할당할 수 있습니다. 그러나 기존 컬렉션의 새 인덱스에 데이터 정렬을 지정할 수 있습니다. 자세한 내용은 이 가이드의 인덱스 섹션을 참조하세요.

다음 스니펫은 items 이라는 새 컬렉션을 만들 때 "en_US" 국가 및 언어 설정 데이터 정렬을 지정하는 방법을 보여줍니다.

database.createCollection(
    "names",
    CreateCollectionOptions().collation(
        Collation.builder().locale("en_US").build()
    )
)

데이터 정렬이 성공적으로 생성되었는지 확인하려면 다음과 같이 해당 collection의 인덱스 목록을 조회하세요.

val collection = database.getCollection<FirstName>("names")
val indexInformation = collection.listIndexes().first()
println(indexInformation.toJson())

{
  // ...
  "collation": {
     "locale": "en_US",
     // ...
  },
  // ...
}

Index

collection에 새 인덱스를 만들 때 데이터 정렬을 지정할 수 있습니다. 인덱스는 문서의 순서가 지정된 표현을 collection에 저장하므로 작업에서 메모리 내 순서 지정을 수행할 필요가 없습니다. 인덱스를 사용하려면 작업이 다음 기준을 충족해야 합니다.

• 이 작업은 인덱스에 지정된 것과 동일한 데이터 정렬을 사용합니다.

• 이 작업은 데이터 정렬이 포함된 인덱스에 의해 처리됩니다.

다음 코드 스니펫은 "en_US" 국가 및 언어 설정 데이터 정렬을 사용하여 "firstName" 필드에 오름차순으로 인덱스를 생성하는 방법을 보여줍니다.

val collection = database.getCollection<FirstName>("names")
val idxOptions = IndexOptions().collation(Collation.builder().locale("en_US").build())
collection.createIndex(Indexes.ascending(FirstName::firstName.name), idxOptions)

데이터 정렬이 성공적으로 생성되었는지 확인하려면 다음과 같이 해당 collection의 인덱스 목록을 조회하세요.

val collection = database.getCollection<FirstName>("names")
val indexInformation = collection.listIndexes().first()
println(indexInformation.toJson())

{
  // ...
  "collation": {
     "locale": "en_US",
     // ...
  },
  // ...
}

다음 코드 스니펫은 동일한 데이터 정렬을 지정하고 이전 코드 스니펫에서 만든 인덱스로 처리되는 작업 예시를 보여줍니다.

val resultsFlow = collection.find()
    .collation(Collation.builder().locale("en_US").build())
    .sort(Sorts.ascending(FirstName::firstName.name));

작업

지원되는 작업 중 하나에 새 데이터 정렬을 매개 변수로 전달하여 컬렉션의 기본 데이터 정렬을 재정의할 수 있습니다. 그러나 이 작업은 인덱스를 사용하지 않기 때문에 인덱스에 포함되는 작업만큼 작업이 수행되지 않을 수 있습니다. 인덱스에 포함되지 않는 정렬 작업의 단점에 대한 자세한 내용은 인덱스를 사용하여 쿼리 결과 정렬에 대한 서버 매뉴얼 페이지를 참조하세요.

다음 코드 스니펫은 다음과 같은 특성을 가진 쿼리 작업의 예시를 보여줍니다.

• 참조된 컬렉션에는 컬렉션 섹션에 지정된 것과 유사한 기본 데이터 정렬 'en_US'가 포함되어 있습니다.

• 쿼리가 collection의 기본 데이터 정렬 인덱스에 포함되지 않는 아이슬란드어("is") 데이터 정렬을 지정합니다.

• 지정된 데이터 정렬은 인덱스에 포함되지 않으므로 정렬 작업은 인메모리에서 수행됩니다.

val findFlow = collection.find()
    .collation(Collation.builder().locale("is").build())
    .sort(Sorts.ascending(FirstName::firstName.name))

데이터 정렬을 지원하지 않는 인덱스 유형

대부분의 MongoDB 인덱스 유형은 데이터 정렬을 지원하지만 다음과 같은 유형은 이진 비교만 지원합니다.

• text

• 2d

• geoHaystack

find() 및 sort() 예시

다음 예제는 collection에서 정렬된 결과를 검색할 때 데이터 정렬을 적용하는 방법을 보여줍니다. 이 작업을 수행하려면 예제 collection에서 find() 를 호출하고 collation() 및 sort() 메서드를 연결하여 결과를 받을 순서를 지정합니다.

예제 collection 에서 이 작업을 수행하면 출력은 다음과 유사해야 합니다.

val resultsFlow = collection.find()
    .collation(Collation.builder().locale("de@collation=phonebook").build())
    .sort(Sorts.ascending(FirstName::firstName.name))
resultsFlow.collect { println(it) }

FirstName(id=3, firstName=Günter, verified=false)
FirstName(id=2, firstName=Gunter, verified=false)
FirstName(id=5, firstName=Hannah, verified=false)
FirstName(id=4, firstName=Jürgen, verified=false)
FirstName(id=1, firstName=Klara, verified=false)

이 섹션에 언급된 메서드 및 클래스에 대한 자세한 내용은 다음 API 문서를 참조하세요.

• find()

• sort()

• 정렬

findOneAndUpdate() 예시

이 섹션에서는 쿼리에서 첫 번째 일치 항목을 업데이트하는 작업에서 데이터 정렬을 지정하는 방법을 보여줍니다. 이 작업에 대한 데이터 정렬을 지정하려면 FindOneAndUpdateOptions 객체를 인스턴스화하고, 데이터 정렬을 설정한 후, findOneAndUpdate() 메서드 호출에 매개변수로 전달합니다.

이 예에서는 다음을 보여줍니다.

• 예제 컬렉션에서 오름차순으로 'Gunter' 앞에 오는 첫 번째 문서를 오름차순으로 검색합니다.

• "de@collation=phonebook" 데이터 정렬을 포함한 작업 옵션을 설정합니다.

• 값이 'true'인 새 필드 'verified'를 추가합니다.

• 업데이트된 문서를 조회하고 출력합니다.

de@collation=phonebook 데이터 정렬을 오름차순으로 사용하여 "Günter"는 어휘적으로 "Gunter" 앞에 있으므로 다음 연산은 결과에서 "Gunter" 앞에 "Günter"를 반환합니다.

val result = collection.findOneAndUpdate(
    Filters.lt(FirstName::firstName.name, "Gunter"),
    Updates.set("verified", true),
    FindOneAndUpdateOptions()
        .collation(Collation.builder().locale("de@collation=phonebook").build())
        .sort(Sorts.ascending(FirstName::firstName.name))
        .returnDocument(ReturnDocument.AFTER)
)
println(result)

FirstName(id=3, firstName=Günter, verified=true)

이 섹션에 언급된 메서드 및 클래스에 대한 자세한 내용은 다음 API 문서를 참조하세요.

• findOneAndUpdate

• findOneAndUpdateOptions

• 필터

• Updates

• 정렬

findOneAndDelete() 예시

이 섹션에서는 쿼리에서 첫 번째 일치 항목을 삭제하는 작업에서 데이터 정렬에서 문자열의 숫자 순서를 지정하는 방법을 보여 줍니다. 이 작업에 대한 데이터 정렬을 지정하려면 FindOneAndDeleteOptions 객체를 인스턴스화하고 숫자 순서 데이터 정렬을 설정한 다음 findOneAndDelete() 메서드 호출에 매개변수로 전달합니다.

이 예시에서는 다음 문서가 포함된 collection에서 findOneAndDelete() 작업을 호출합니다.

{ "_id" : 1, "a" : "16 apples" }
{ "_id" : 2, "a" : "84 oranges" }
{ "_id" : 3, "a" : "179 bananas" }

이러한 문서는 다음 데이터 클래스로 표시됩니다.

data class CollationExample(@BsonId val id: Int, val a: String)

데이터 정렬에서는 숫자 순서를 기준으로 문자열을 정렬하기 위해 locale 옵션을 "en"으로 설정하고 numericOrdering 옵션을 "true"로 설정합니다.

val result = collection.findOneAndDelete(
    Filters.gt(CollationExample::a.name, "100"),
    FindOneAndDeleteOptions()
        .collation(Collation.builder().locale("en").numericOrdering(true).build())
        .sort(Sorts.ascending(CollationExample::a.name))
)
println(result)

CollationExample(id=3, a=179 bananas)

문자열 "179"의 숫자 값이 숫자 100보다 크므로 앞의 문서가 유일하게 일치합니다.

3개 문서의 원본 컬렉션에 대해 숫자 순서 데이터 정렬 없이 동일한 작업을 수행하는 경우, 필터는 바이너리 데이터 정렬로 정렬할 때 '100' 이 '16', '84', '179' 보다 앞에 오게 되므로 모든 문서와 일치합니다.

이 섹션에 언급된 메서드 및 클래스에 대한 자세한 내용은 다음 API 문서를 참조하세요.

• findOneAndDelete

• FindOneAndDeleteOptions

• 필터

• 정렬

집계 예시

이 섹션에서는 애그리게이션 작업에서 데이터 정렬을 지정하는 방법을 설명합니다. 애그리게이션 작업에서는 집합적으로 집계 파이프라인이라고 하는 일련의 애그리게이션 단계를 지정할 수 있습니다. 애그리게이션을 수행하려면 MongoCollection 객체에서 aggregate() 메서드를 호출합니다.

애그리게이션 작업에 대한 데이터 정렬을 지정하려면 애그리게이션 작업에서 반환된 AggregateFlow 에서 collation() 메서드를 호출합니다. 집계 파이프라인에서 데이터 정렬을 적용할 정렬 애그리게이션 단계를 지정해야 합니다.

다음 예시는 예시 컬렉션에서 집계 파이프라인을 생성하고 다음을 지정하여 데이터 정렬을 적용하는 방법을 보여 줍니다.

• Aggregates.group() 헬퍼를 사용하여 firstName 필드로 각 문서를 식별하고 해당 값을 결과의 _id 로 사용하는 그룹 애그리게이션 단계입니다.

• 그룹 애그리게이션 단계에서 firstName 필드에서 값이 일치하는 인스턴스 수를 합산하는 축적자입니다.

• 이전 애그리게이션 단계의 출력 문서의 _id 필드에 오름차순 정렬을 적용합니다.

• 독일어 국가 및 언어 설정과 악센트 및 움라우트를 무시하는 데이터 정렬 강도를 지정하여 데이터 정렬 객체를 생성합니다.

data class Result(@BsonId val id: String, val nameCount: Int)
val groupStage = Aggregates.group(
    "\$${FirstName::firstName.name}",
    Accumulators.sum("nameCount", 1)
)
val sortStage = Aggregates.sort(Sorts.ascending("_id"))
val resultsFlow = collection.aggregate<Result>(listOf(groupStage, sortStage))
    .collation(
        Collation.builder().locale("de")
            .collationStrength(CollationStrength.PRIMARY)
            .build()
    )
resultsFlow.collect { println(it) }

Result(id=Gunter, nameCount=2)
Result(id=Hannah, nameCount=1)
Result(id=Jürgen, nameCount=1)
Result(id=Klara, nameCount=1)

이 섹션에 언급된 메서드 및 클래스에 대한 자세한 내용은 다음 API 문서를 참조하세요.

• 집계()

• AggregateFlow

• 데이터 정렬 강도

• 축적자

• 집계

• 정렬