/ /

문서 찾기

개요

이 가이드 에서는 코틀린 동기 (Kotlin Sync) 운전자 를 사용하여 읽기 작업을 통해 MongoDB 컬렉션 에서 데이터를 조회 하는 방법을 학습 수 있습니다. find() 메서드를 호출하여 쿼리 필터하다 에 지정된 설정하다 과 일치하는 문서를 조회 할 수 있습니다.

샘플 데이터

이 가이드의 예시에서는 Atlas 샘플 데이터 세트의 sample_restaurants 데이터베이스에 있는 restaurants 컬렉션을 사용합니다. 무료 MongoDB 배포서버를 생성하고 샘플 데이터 세트를 로드하는 방법을 알아보려면 MongoDB 시작하기 가이드를 참조하세요.

이 컬렉션 의 문서는 다음 코틀린 (Kotlin) 데이터 클래스에 따라 모델링됩니다.

data class Restaurant(
    val name: String,
    val cuisine: String
)

문서 찾기

find() 메서드는 컬렉션 에서 문서를 검색합니다. 이 메서드는 쿼리 필터하다 를 사용하여 일치하는 모든 문서를 반환합니다. 쿼리 필터하다 는 운전자 가 컬렉션 의 문서를 일치시키는 데 사용하는 기준을 지정하는 문서 입니다.

쿼리 필터에 학습 보려면 쿼리 지정 가이드 를 참조하세요.

하나의 문서 찾기 예시

다음 예시 에서는 first() 메서드를 find() 메서드 호출에 연결하여 cuisine 필드 의 값이 "Spanish"인 첫 번째 문서 찾습니다.

val results = collection.find(eq(Restaurant::cuisine.name, "Spanish")).first()

앞의 예시 에서 find() 작업은 다음 예시 와 같이 인쇄할 수 있는 MongoDB 문서 반환합니다.

val results = collection.find(eq(Restaurant::cuisine.name, "Spanish")).first()
println(results)

Restaurant(name=Tropicoso Club, cuisine=Spanish)

문서 찾기 예시

다음 예시 에서는 find() 메서드를 사용하여 cuisine 필드 의 값이 "Spanish" 인 모든 문서를 찾습니다.

val results = collection.find(eq(Restaurant::cuisine.name, "Spanish"))

앞의 예시 에서 find() 작업은 FindIterable 객체 를 반환하며, 다음 예시 와 같이 forEach() 메서드를 사용하여 반복할 수 있습니다.

val results = collection.find(eq(Restaurant::cuisine.name, "Spanish"))
results.forEach { result ->
    println(result)
}

Restaurant(name=Tropicoso Club, cuisine=Spanish)
Restaurant(name=Beso, cuisine=Spanish)
Restaurant(name=Sabor Latino Restaurant, cuisine=Spanish)
...

참고

모든 문서 찾기

컬렉션의 모든 문서를 찾으려면 find() 메서드에 빈 필터를 전달합니다.

val results = collection.find()

검색 동작 수정

메서드를 find() 메서드 호출에 연결하여 find() 메서드의 동작을 수정할 수 있습니다. 다음 표에서는 쿼리 수정에 일반적으로 사용되는 메서드에 대해 설명합니다.

메서드	설명
`batchSize()`	배치 당 반환할 문서 수를 제한합니다. 배치 크기에 대해 자세히 학습 MongoDB Server 매뉴얼에서 커서 .batchSize()를 참조하세요.
`collation()`	쿼리 에 대한 데이터 정렬 옵션을 설정합니다.
`comment()`	쿼리 에 첨부할 문자열을 지정합니다. 이렇게 하면 서버 로그와 프로필 데이터에서 작업을 추적하고 해석하는 데 도움이 될 수 있습니다.
`first()`	쿼리 와 일치하는 첫 번째 문서 반환하거나 일치하는 문서가 없는 경우 `MongoClientException` 을 발생시킵니다.
`firstOrNull()`	쿼리 와 일치하는 첫 번째 문서 반환하거나 일치하는 문서가 없는 경우 `null` 을 반환합니다.
`hint()`	쿼리 에 사용할 인덱스 지정합니다.
`limit()`	쿼리 에서 반환할 문서 수를 제한합니다.
`skip()`	건너뛸 문서 수를 설정합니다.
`sort()`	쿼리 에 적용 할 정렬 기준을 정의합니다.

다음 예시 에서는 limit() 메서드를 연결하여 쿼리 에서 반환되는 문서 수를 10(으)로 제한합니다.

val results = collection
    .find(eq(Restaurant::cuisine.name, "Spanish"))
    .limit(10)

의 동작을 수정하는 find() 메서드의 전체 목록은 클래스에 대한 API 설명서를 FindIterable 참조하세요.

추가 정보

쿼리 필터에 대해 자세히 알아보려면 쿼리 지정을 참조하세요.

코틀린 동기 (Kotlin Sync) 운전자 사용하여 문서를 조회 실행 가능한 코드 예제를 보려면 문서 찾기를 참조하세요.

API 문서

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

돌아가기

문서 삽입

반환할 문서 지정