문서 메뉴

문서 홈 → 애플리케이션 개발 → MongoDB 매뉴얼

쿼리에서 반환할 프로젝트 필드

이 페이지의 내용

  • 일치하는 문서의 모든 필드 반환
  • 지정된 필드 및 _id 필드만 반환
  • _id 필드 억제
  • 제외된 필드를 제외한 모든 필드 반환
  • 포함된 문서에서 특정 필드 반환
  • 포함된 문서에서 특정 필드 미표시
  • 배열에서 포함된 문서에 프로젝션
  • 반환된 배열에 프로젝트별 배열 요소 프로젝션
  • 집계 표현식으로 필드 투영
  • 추가 고려 사항

➤ 오른쪽 상단의 언어 선택 드롭다운 메뉴를 사용하여 다음 예시의 언어를 설정합니다.

MongoDB의 쿼리는 기본적으로 일치하는 문서에 존재하는 모든 필드를 반환합니다. MongoDB가 애플리케이션에 전송하는 데이터의 양을 제한하기 위해 프로젝션 문서를 포함하여 반환할 필드를 지정하거나 제한할 수 있습니다.

일치하는 문서의 모든 필드 반환

다음 예시에서는 inventory 컬렉션에 있는 모든 문서에서 status가 "A"와 같은 모든 필드를 반환합니다.

이 작업은 다음 SQL 문에 해당합니다.

SELECT * from inventory WHERE status = "A"

지정된 필드 및 _id 필드만 반환

프로젝션 문서에서 <field>를 1로 설정하여 프로젝션에 여러 필드를 명시적으로 포함할 수 있습니다. 다음 작업은 쿼리와 일치하는 모든 문서를 반환합니다. 결과 세트에서는 item, status 및 기본적으로 _id 필드만 일치하는 문서에 반환됩니다.

이 작업은 다음 SQL 문에 해당합니다.

SELECT _id, item, status from inventory WHERE status = "A"

_id 필드 표시 안 함

다음 예시와 같이 프로젝션에서 _id 필드를 0으로 설정하여 결과에서 제거할 수 있습니다.

이 작업은 다음 SQL 문에 해당합니다.

SELECT item, status from inventory WHERE status = "A"

참고

_id 필드를 제외하고 프로젝션 문서에서는 포함 및 제외 문을 결합할 수 없습니다.

제외된 필드를 제외한 모든 필드 반환

일치하는 문서에 반환할 필드를 나열하는 대신 프로젝션을 사용하여 특정 필드를 제외할 수 있습니다. 일치하는 문서에서 status 및 instock 필드를 제외한 모든 필드를 반환하는 다음 예시는 아래를 실행합니다.

참고

_id 필드를 제외하고 프로젝션 문서에서는 포함 및 제외 문을 결합할 수 없습니다.

포함된 문서에서 특정 필드 반환

포함된 문서의 특정 필드를 반환할 수 있습니다. 점 표기법을 사용하여 포함된 필드를 참조하고 프로젝션 문서에서 1로 설정합니다.

다음 예시는 다음을 반환합니다.

  • _id 필드(기본적으로 반환됨)

  • item 필드

  • status 필드

  • size 문서의 uom 필드

uom 필드는 size 문서에 포함된 상태로 유지됩니다.

중첩된 양식을 사용하여 포함된 필드를 지정할 수도 있습니다. 예를 들어 { item: 1, status: 1, size: { uom: 1 } } 입니다.

포함된 문서에서 특정 필드 미표시

포함된 문서에 특정 필드를 표시하지 않을 수 있습니다. 점 표기법을 사용하여 프로젝션 문서의 포함된 필드를 참조하고 0로 설정합니다.

다음 예시에서는 size 문서의 uom 필드를 제외하도록 프로젝션을 지정합니다. 다른 모든 필드는 일치하는 문서에서 반환됩니다.

중첩된 양식을 사용하여 포함된 필드를 지정할 수도 있습니다. 예를 들어 { size: { uom: 0 } } 입니다.

배열에서 포함된 문서에 프로젝션

점 표기법을 사용하여 배열에 포함된 문서의 특정 필드를 투영할 수 있습니다.

다음 예시에서는 반환할 프로젝션을 지정합니다.

  • _id 필드(기본적으로 반환됨)

  • item 필드

  • status 필드

  • instock 배열에 포함된 문서의 qty 필드

반환된 배열에 프로젝트별 배열 요소 프로젝션

집계 표현식으로 필드 투영

쿼리 프로젝션에서 집계 표현식을 지정할 수 있습니다. 집계 표현식을 사용하면 새 필드를 투영하고 기존 필드의 값을 수정할 수 있습니다.

예를 들어 다음 작업은 집계 표현식을 사용하여 status 필드의 값을 재정의하고 새 필드 area 및 reportNumber를 투영합니다.

참고

다음 예제에서는 MongoDB Shell 구문을 사용합니다. 애그리게이션을 사용한 프로젝션의 드라이버 예제는 드라이버 설명서를 참조하세요.

db.inventory.find(
   { },
   {
      _id: 0,
      item: 1,
      status: {
         $switch: {
            branches: [
               {
                  case: { $eq: [ "$status", "A" ] },
                  then: "Available"
               },
               {
                  case: { $eq: [ "$status", "D" ] },
                  then: "Discontinued"
               },
            ],
            default: "No status found"
         }
      },
      area: {
         $concat: [
            { $toString: { $multiply: [ "$size.h", "$size.w" ] } },
            " ",
            "$size.uom"
         ]
      },
      reportNumber: { $literal: 1 }
   }
)
[
   {
      item: 'journal',
      status: 'Available',
      area: '294 cm',
      reportNumber: 1
   },
   {
      item: 'planner',
      status: 'Discontinued',
      area: '685.5 cm',
      reportNumber: 1
   },
   {
      item: 'notebook',
      status: 'Available',
      area: '93.5 in',
      reportNumber: 1
   },
   {
      item: 'paper',
      status: 'Discontinued',
      area: '93.5 in',
      reportNumber: 1
   },
   {
      item: 'postcard',
      status: 'Available',
      area: '152.5 cm',
      reportNumber: 1
   }
]

추가 고려 사항

MongoDB는 프로젝션과 관련하여 추가 제한 사항을 시행합니다. 자세한 내용은 프로젝션 제한 사항을 참조하세요.

팁

다음도 참조하세요.

← 임베디드 문서 배열 쿼리하기
null 또는 누락된 필드에 대한 쿼리 →

이 페이지의 내용