커서.returnKey() (mongosh 메서드)

정의

cursor.returnKey()

중요

Mongo쉬 방법

이 페이지에서는 mongosh 메서드를 설명합니다. 이는 Node.js와 같은 언어별 드라이버에 대한 설명서가 아닙니다.

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

팁

$meta 는 인덱스가 사용되는 경우 인덱스 키 메타데이터를 반환하는 키워드 "indexKey" 을 지원합니다. cursor.returnKey() 보다 { $meta: "indexKey" } 을 사용하는 것이 좋습니다

문서가 아닌 인덱스 키를 반환하도록 커서를 수정합니다.

cursor.returnKey() 의 형식은 다음과 같습니다.

cursor.returnKey()

반환합니다:	`returnKey()` 수정된 결과 집합으로 가 연결되는 커서 입니다. 이를 통해 추가 커서 수정자를 연결할 수 있습니다.

호환성

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

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

참고

이 명령은 모든 MongoDB Atlas 클러스터에서 지원됩니다. 모든 명령에 대한 Atlas 지원에 관해 자세히 알아보려면 지원되지 않는 명령을 참조하십시오.

MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전

행동

쿼리가 읽기 작업을 수행하는 데 인덱스를 사용하지 않으면 커서는 빈 문서를 반환합니다.

예시

restaurants collection에는 다음 스키마를 가진 문서가 포함되어 있습니다.

db.restaurants.insertOne(
   {
      _id: ObjectId("564f3a35b385149fc7e3fab9"),
      address: {
         building: "2780",
         coord: [
            -73.98241999999999,
            40.579505
         ],
         street: "Stillwell Avenue",
         zipcode: "11224"
      },
      borough: "Brooklyn",
      cuisine: "American ",
      grades: [
         {
            date: ISODate("2014-06-10T00:00:00Z"),
            grade: "A",
            score: 5
         },
         {
            date: ISODate("2013-06-05T00:00:00Z"),
            grade: "A",
            score: 7
         }
      ],
      name: "Riviera Caterer",
      restaurant_id: "40356018"
   }
)

collection에는 기본 _id 인덱스 외에 두 개의 인덱스가 있습니다.

{
   "v" : 1,
   "key" : {
      "_id" : 1
   },
   "name" : "_id_",
   "ns" : "guidebook.restaurant"
},
{
   "v" : 1,
   "key" : {
      "cuisine" : 1
   },
   "name" : "cuisine_1",
   "ns" : "guidebook.restaurant"
},
{
   "v" : 1,
   "key" : {
      "_fts" : "text",
      "_ftsx" : 1
   },
   "name" : "name_text",
   "ns" : "guidebook.restaurant",
   "weights" : {
      "name" : 1
   },
   "default_language" : "english",
   "language_override" : "language",
   "textIndexVersion" : 3
}

다음 코드는 cursor.returnKey() 메서드를 사용하여 쿼리 실행에 사용되는 인덱싱된 필드만 반환합니다.

var csr = db.restaurant.find( { "cuisine" : "Japanese" } )
csr.returnKey()

그러면 다음이 반환됩니다:

{ "cuisine" : "Japanese" }
{ "cuisine" : "Japanese" }
{ "cuisine" : "Japanese" }
{ "cuisine" : "Japanese" }
...

돌아가기

커서.readPref

커서.showRecordId