흐름에서 데이터 액세스

첫 번째 문서 찾기

firstOrNull() 쿼리 결과에서 첫 번째 문서를 조회하려면 메서드를 사용하고,null 결과가 없는 경우 메서드를 사용합니다.

val resultsFlow = collection.find()
val firstResultOrNull = resultsFlow.firstOrNull()

또는 first() 메서드를 사용하여 쿼리에서 첫 번째 문서를 조회하거나 결과가 없는 경우 NoSuchElementException 을 발생시킬 수 있습니다.

try {
    val resultsFlow = collection.find()
    val firstResult = resultsFlow.first()
} catch (e: NoSuchElementException) {
    println("No results found")
}

이러한 메서드는 고유 인덱스로 필터링할 때와 같이 쿼리 필터가 하나의 문서와 일치할 때 자주 사용됩니다.

결과 수 계산

count() 메서드를 사용하여 쿼리에서 결과 수를 검색합니다.

val resultsFlow = collection.find()
val count = resultsFlow.count()

결과를 목록으로 변환

toList() 메서드를 사용하여 쿼리 결과를 List 에 저장합니다.

val resultsFlow = collection.find()
val results = resultsFlow.toList()

이 메서드는 쿼리 필터가 사용 가능한 메모리에 들어갈 수 있는 적은 수의 문서를 반환할 때 자주 사용됩니다.

결과 반복

collect() 메서드를 사용하여 가져온 문서를 반복하고 조기 종료 시 흐름이 닫히도록 합니다.

val resultsFlow = collection.find()
resultsFlow.collect { println(it) }

쿼리 설명

explain() 메서드를 사용하여 MongoDB가 작업을 실행하는 방법에 대한 정보를 볼 수 있습니다.

explain() 메서드는 실행 계획 및 성능 통계를 반환합니다. 실행 계획은 MongoDB가 작업을 완료할 수 있는 잠재적인 방법입니다. explain() 메서드는 성공적인 계획(MongoDB가 실행한 계획)과 거부된 계획을 모두 제공합니다.

explain() 메소드에 상세 수준을 전달하여 설명의 세부 정보 수준을 지정할 수 있습니다.

다음 표에는 설명 및 해당 사용 사례에 대한 모든 상세 수준이 나와 있습니다.

다음 예제에서는 실행 계획을 생성하는 애그리게이션 단계에 대한 성공적인 계획의 JSON 표현을 출력합니다.

val explanation = collection.find().explain(ExplainVerbosity.EXECUTION_STATS)
val jsonSummary = explanation.getEmbedded(
    listOf("queryPlanner", "winningPlan"),
    Document::class.java
).toJson()
println(jsonSummary)

{ "stage": "COLLSCAN", "direction": "forward" }

explain 작업에 대한 자세한 내용은 다음 서버 매뉴얼 항목을 참조하세요.

• 설명 출력

• 쿼리 계획

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

• collect()

• explain()

• ExplainVerbosity