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

정의

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

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

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

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

중요

If the query plan changes to use a different index, the method may return a different document. If your use case requires that a particular record is chosen consistently, you must use the options document to specify a sort. For details on using findOne() with an options document, see the example.

If you specify a projection parameter, findOne() returns a document that only contains the projection fields. The _id field is always included unless you explicitly exclude it.

참고

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

호환성

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

• MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud

• 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 배포서버에 로드하는 방법에 대한 자세한 내용은 샘플 데이터세트 로드를 참조하세요. 샘플 데이터베이스를 수정한 경우, 이 페이지의 예시를 실행하려면 데이터베이스를 제거하고 다시 생성해야 할 수 있습니다.

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' }