db.collection.findOne()

정의

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

중요

Mongo쉬 방법

이 페이지에서는 mongosh 메서드에 대해 설명합니다. 이는 데이터베이스 명령 또는 Node.js와 같은 언어별 드라이버에 대한 설명서가 아닙니다.

데이터베이스 명령의 경우 find 명령을 참조하세요.

MongoDB API 드라이버의 경우 언어별 MongoDB 드라이버 설명서를 참조하세요.

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

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

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

중요

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

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

참고

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

호환성

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

• MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스

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

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

구문

findOne() 메서드의 형식은 다음과 같습니다.

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

findOne() 메서드는 다음 매개변수를 사용합니다.

행동

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

예시

db.bios.findOne()

db.bios.findOne(
   {
     $or: [
            { 'name.first' : /^G/ },
            { birth: { $lt: new Date('01/01/1945') } }
          ]
   }
)

db.bios.findOne(
    { },
    { name: 1, contribs: 1 }
)

db.bios.findOne(
   { contribs: 'OOP' },
   { _id: 0, 'name.first': 0, birth: 0 }
)

db.bios.findOne(
   { },
   { },
   { sort: { birth: 1 } }
)

var myDocument = db.bios.findOne();
if (myDocument) {
   var myName = myDocument.name;
   print (tojson(myName));
}

db.cakeFlavors.insertMany( [
   { _id: 1, flavor: "chocolate" },
   { _id: 2, flavor: "strawberry" },
   { _id: 3, flavor: "cherry" }
] )

db.cakeFlavors.findOne(
   { $expr: { $eq: [ "$flavor", "$$targetFlavor" ] } },
   { _id: 0 },
   { let : { targetFlavor: "chocolate" }
} )

{ flavor: 'chocolate' }