/ /

Java Reactive Streams 드라이버

Java Reactive Streams 드라이버

문서 쿼리

문서 수 계산

개요

이 가이드 에서는 컬렉션 에 있는 문서 수의 정확한 개수와 예상 개수를 조회 하는 방법을 학습 수 있습니다.

샘플 데이터

이 가이드 의 예제에서는 Atlas 샘플 데이터 세트 의 sample_restaurants.restaurants 컬렉션 을 사용합니다. 무료 MongoDB Atlas cluster 를 생성하고 샘플 데이터 세트를 로드하는 방법을 학습 보려면 시작하기를 참조하세요.

중요

프로젝트 리액터 라이브러리

이 가이드 에서는 Project Reactor 라이브러리를 사용하여 Java Reactive Streams 운전자 메서드에서 반환된 Publisher 인스턴스를 사용합니다. 프로젝트 Reactor 라이브러리와 사용 방법에 대해 자세히 학습 Reactor 문서에서 시작하기 참조하세요. 이 가이드에서 Project Reactor 라이브러리 메서드를 사용하는 방법에 대해 자세히 학습하려면 MongoDB에 데이터 쓰기 가이드를 참조하세요.

정확한 개수 조회

컬렉션 의 문서 수를 계산하려면 countDocuments() 메서드를 사용합니다. 특정 검색 기준과 일치하는 문서 수를 계산하려면 countDocuments() 메서드에 쿼리 필터하다 를 전달합니다.

쿼리 지정에 학습 보려면 쿼리 지정을 참조하세요.

모든 문서 계산

컬렉션 에 있는 모든 문서의 개수를 반환하려면 다음 예시 와 같이 countDocuments() 메서드를 호출하고 매개 변수를 전달하지 않습니다.

Publisher<Long> countPublisher = restaurants.countDocuments();
Mono.from(countPublisher).doOnNext(System.out::println).blockLast();

특정 문서 수 계산

특정 검색 기준과 일치하는 문서 수를 반환하려면 다음 예시 와 같이 countDocuments() 메서드에 쿼리 를 지정합니다. 쿼리 를 지정하는 방법에 대한 학습 내용은 쿼리 지정 가이드 를 참조하세요.

Publisher<Long> countPublisher = restaurants.countDocuments(
        eq("cuisine", "Italian"));
Mono.from(countPublisher)
        .doOnNext(System.out::println)
        .blockLast();

카운트 동작 사용자 지정

메서드에 선택적 매개변수를 전달하여 countDocuments() 메서드의 동작을 수정할 수 있습니다. CountOptions 클래스는 countDocuments() 메서드의 동작을 수정하는 메서드를 제공합니다. CountOptions 클래스를 사용하려면 클래스의 새 인스턴스 를 구성한 다음 해당 메서드 중 하나 이상을 호출하여 카운트 작업을 수정합니다. 이러한 메서드 호출을 함께 연결할 수 있습니다.

카운트 작업의 동작을 수정하려면 클래스 인스턴스 와 연결된 메서드 호출을 countDocuments() 메서드의 마지막 인수로 전달합니다.

다음 표에서는 CountOptions 클래스의 메서드에 대해 설명합니다.

메서드	설명
`collation(Collation collation)`	결과를 정렬할 때 사용할 언어 데이터 정렬의 종류를 지정합니다. 자세한 내용은 MongoDB Server 매뉴얼에서 데이터 정렬 을 참조하세요.
`comment(BsonValue comment)`	작업에 `BsonValue` 주석을 첨부합니다. 자세한 내용은 MongoDB Server 매뉴얼의 명령 필드 삽입 가이드 참조하세요.
`comment(String comment)`	작업에 `String` 주석을 첨부합니다. 자세한 내용은 MongoDB Server 매뉴얼의 명령 필드 삽입 가이드 참조하세요.
`hint(Bson hint)`	작업의 인덱스 `Bson` 값으로 설정합니다. 자세한 내용은 MongoDB Server 매뉴얼의 힌트 성명서 참조하세요.
`hintString(String hint)`	작업의 인덱스 `String` 값으로 설정합니다. 자세한 내용은 MongoDB Server 매뉴얼의 힌트 성명서 참조하세요.
`limit(int limit)`	커서 반환하는 최대 문서 수에 대한 제한을 설정합니다. 자세한 내용은 MongoDB Server 문서에서 커서 참조하세요.
`skip(int skip)`	결과를 반환하기 전에 쿼리 건너뛰는 문서 수를 설정합니다. 자세한 내용은 MongoDB Server 매뉴얼에서 건너뛰기를 참조하세요.

개수 수정 예시

다음 코드는 countDocuments() 메서드를 사용하여 cuisine 값이 "Italian" 인 restaurants 컬렉션 의 모든 문서 수를 계산합니다. 또한 "Count all Italian restaurants" 작업에 주석을 로 String 첨부합니다.

Publisher<Long> countPublisher = restaurants.countDocuments(
        eq("cuisine", "Italian"),
       new CountOptions().comment("Count all Italian restaurants"));
Mono.from(countPublisher)
        .doOnNext(System.out::println)
        .blockLast();

예상 개수 조회

estimatedDocumentCount() 메서드를 호출하여 컬렉션 에 있는 문서 수의 추정치를 얻을 수 있습니다. 이 메서드는 컬렉션 메타데이터 를 기반으로 문서 수를 추정하며, 이는 정확한 개수를 계산하는 것보다 빠를 수 있습니다.

다음 예에서는 컬렉션의 문서 수를 추정합니다.

Publisher<Long> countPublisher = restaurants.estimatedDocumentCount();
Mono.from(countPublisher)
        .doOnNext(System.out::println)
        .blockLast();

예상 카운트 동작 사용자 지정

메서드에 선택적 매개변수를 전달하여 estimatedDocumentCount() 메서드의 동작을 수정할 수 있습니다. EstimatedDocumentCountOptions 클래스는 estimatedDocumentCount() 메서드의 동작을 수정하는 메서드를 제공합니다. EstimatedDocumentCountOptions 클래스를 사용하려면 클래스의 새 인스턴스 를 구성한 다음 해당 메서드 중 하나 이상을 호출하여 카운트 작업을 수정합니다. 이러한 메서드 호출을 함께 연결할 수 있습니다.

카운트 작업의 동작을 수정하려면 클래스 인스턴스 와 연결된 메서드 호출을 estimatedDocumentCount() 메서드의 유일한 인수로 전달합니다.

다음 표에서는 estimatedDocumentCount() 을(를) 사용자 지정하기 위해 설정할 수 있는 옵션에 대해 설명합니다.

속성	설명
`comment(BsonValue comment)`	작업에 `BsonValue` 주석을 첨부합니다. 자세한 내용은 MongoDB Server 매뉴얼의 명령 필드 삽입 가이드 참조하세요.
`comment(String comment)`	작업에 `String` 주석을 첨부합니다. 자세한 내용은 MongoDB Server 매뉴얼의 명령 필드 삽입 가이드 참조하세요.

예상 개수 수정 예시

다음 코드는 estimatedDocumentCount() 메서드를 사용하여 restaurants 컬렉션 의 문서 수를 추정합니다. 또한 "Estimated count of all documents" 를 작업에 String 으로 연결합니다.

Publisher<Long> countPublisher = restaurants.estimatedDocumentCount(
        new EstimatedDocumentCountOptions()
                .comment("Estimated count of all documents"));
Mono.from(countPublisher)
        .doOnNext(System.out::println)
        .blockLast();

API 문서

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

돌아가기

반환할 필드 지정

고유 필드 값 검색