db.collection.findOne()

클라이언트 연결 해제

MongoDB 4.2부터 db.collection.findOne()를 발급한 클라이언트가 작업이 완료되기 전에 연결을 끊는 경우, MongoDB는 db.collection.findOne()를 사용하여 를killOp을 종료로 표시합니다.

프로젝션

projection 매개변수는 일치하는 문서에서 어떤 필드가 반환되는지를 결정합니다. projection 매개변수는 다음 형식의 문서를 사용합니다.

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

빈 쿼리 사양 사용

다음 작업은 bios collection에서 단일 문서를 반환합니다.

db.bios.findOne()

쿼리 사양 사용

다음 작업은 name 내장된 문서의 first 필드가 G 문자로 시작하는 경우 또는 birth 필드가 new Date('01/01/1945') 값 미만인 경우 BIOS 컬렉션에서 일치하는 첫 번째 문서를 반환합니다.

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

프로젝션 사용

projection 매개변수는 반환할 필드를 지정합니다. 매개변수에는 포함 또는 제외 사양이 있으며 _id 필드에 대한 제외 사양이 아닌 경우 둘 다 포함되지는 않습니다.

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

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

옵션 포함

다음 작업은 sort 옵션을 사용하여 정렬된 bios 컬렉션에서 일치하는 첫 번째 문서를 반환합니다. 이 예시에서 컬렉션은 birth 기준으로 오름차순으로 정렬됩니다.

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

findOne 결과 문서

단일 문서가 반환되기 때문에 커서 메서드를 findOne() 결과에 적용할 수 없습니다. 다음과 같은 방법으로 문서에 직접 액세스할 수 있습니다.

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

let 옵션에 변수 사용

쿼리 옵션을 지정하여 쿼리 동작을 수정하고 결과가 반환되는 방식을 지정할 수 있습니다.

예를 들어 findOne 메서드의 다른 곳에서 액세스할 수 있는 변수를 정의하려면 let 옵션을 사용합니다. 변수를 사용하여 결과를 필터링하려면 $expr 연산자 내에서 변수에 액세스해야 합니다.

컬렉션 cakeFlavors을 만듭니다:

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

다음 예시에서는 let에 targetFlavor 변수를 정의하고 이 변수를 사용하여 초콜릿 케이크 맛을 검색합니다.

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

출력:

{ flavor: 'chocolate' }

사용 가능한 모든 쿼리 옵션을 보려면 FindOptions를 참조하세요.