db. 컬렉션.findOne() (mongosh 메서드)

정의

db.collection.findOne(query, projection, options)

collection 또는 뷰에 지정된 쿼리 기준을 충족하는 문서 한 개를 반환합니다.

반환되는 문서는 쿼리 기준과 일치하는 문서 수 및 사용된 쿼리 계획에 따라 달라질 수 있습니다.

일치하는 문서 수	쿼리 계획	결과
0	Any	이 메서드는 다음을 반환합니다. null
1	Any	이 메서드는 지정된 쿼리 기준을 충족하는 문서를 반환합니다.
2 이상	컬렉션 스캔	이 메서드는 기본 순서에 따라 첫 번째 문서를 반환합니다. 고정 사이즈 컬렉션에서 기본 순서는 삽입 순서와 동일합니다.
2 이상	인덱스 스캔	이 메서드는 인덱스에서 조회된 첫 번째 문서를 반환합니다.

중요

다른 인덱스 사용하도록 쿼리 계획 변경되면 메서드는 다른 문서 반환할 수 있습니다. 사용 사례 에서 특정 기록 일관되게 선택해야 하는 경우 options 문서 사용하여 정렬을 지정해야 합니다. options 문서 에서 findOne()을 사용하는 방법에 대한 자세한 내용은 예시 를 참조하세요.

projection 매개변수를 지정하면findOne()는 projection 필드만 포함된 문서 반환합니다. _id 필드 명시적으로 제외하지 않는 한 항상 포함됩니다.

참고

find() 메서드와 비슷하지만 findOne() 은 커서가 아닌 문서를 반환합니다.

호환성

이 메서드는 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.

• MongoDB Atlas: cloud 에서의 MongoDB 배포를 위한 완전 managed 서비스

• MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전

• MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전

구문

db.collection.findOne() 의 형식은 다음과 같습니다.

db.collection.findOne( <query>, <projection>, <options> )

db.collection.findOne() 다음 매개변수를 사용합니다.

행동

{ field1: <value>, field2: <value> ... }

예시

이 페이지의 예제에서는 sample_mflix 데이터 세트의 데이터를 사용합니다. 이 데이터 세트를 자체 관리형 MongoDB deployment 에 로드하는 방법에 대한 자세한 내용은 샘플 데이터 세트 로드를 참조하세요. 샘플 데이터베이스를 수정한 경우 이 페이지의 예제를 실행 하려면 데이터베이스를 삭제하고 다시 만들어야 할 수 있습니다.

db.movies.findOne()

db.movies.findOne(
   {
      $or: [
            { title: /^T/ },
            { year: { $lt: 1950 } }
            ]
   }
)

db.movies.findOne(
   { },
   { title: 1, genres: 1, imdb: 1 }
)

db.movies.findOne(
   { cast: 'Al Pacino' },
   { _id: 0, 'imdb.votes': 0, fullplot: 0 }
)

db.movies.findOne(
   { },
   { },
   { sort: { year: 1 } }
)

var myDocument = db.movies.findOne();
if (myDocument) {
   var myTitle = myDocument.title;
   print(myTitle);
}

db.movies.findOne(
   { $expr: { $eq: [ "$title", "$$targetTitle" ] } },
   { _id: 0, title: 1, year: 1 },
   { let : { targetTitle: "The Godfather" } }
)

{ year: 1972, title: 'The Godfather' }