MongoDB - Query에서 반환할 projectjon field

💡 MongoDB 공식문서를 참고하였다.

참고 : https://docs.mongodb.com/manual/tutorial/project-fields-from-query-results/

Project Fields to Return from Query — MongoDB Manual

 

Query에서 반환할 프로젝트 field

inventory collection 기반으로 예제를 진행한다.

db.inventory.insertMany( [
  { item: "journal", status: "A", size: { h: 14, w: 21, uom: "cm" }, instock: [ { warehouse: "A", qty: 5 } ] },
  { item: "notebook", status: "A",  size: { h: 8.5, w: 11, uom: "in" }, instock: [ { warehouse: "C", qty: 5 } ] },
  { item: "paper", status: "D", size: { h: 8.5, w: 11, uom: "in" }, instock: [ { warehouse: "A", qty: 60 } ] },
  { item: "planner", status: "D", size: { h: 22.85, w: 30, uom: "cm" }, instock: [ { warehouse: "A", qty: 40 } ] },
  { item: "postcard", status: "A", size: { h: 10, w: 15.25, uom: "cm" }, instock: [ { warehouse: "B", qty: 15 }, { warehouse: "C", qty: 35 } ] }
]);

기본적으로 MongoDB의 쿼리는 일치하는 document의 모든 field를 반환한다. MongoDB가 애플리케이션에 보내는 데이터의 양을 제한하기 위해 projection document를 포함하여 반환할 field를 지정하거나 제한할 수 있다.

projection 개념 참조 : http://www.gurubee.net/lecture/2176

SELECT 기초

 

일치하는 document의 모든 field 반환

• ex) status : “A”에 일치하는 inventory collection의 모든 document에서 모든 field를 반환한다.

Mongodb shell

db.inventory.find( { status: "A" } )

SQL

SELECT * from inventory WHERE status = "A"

 

지정된 field 및 _id field만 반환

• ex) item, status 그리고 _id field만 일치하는 document를 반환한다.

db.inventory.find( { status: "A" }, { item: 1, status: 1 } )

SQL

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

 

• _id 필드 억제
  • ex) 프로젝션에서 _id 필드를 0으로 설정하여 결과에서 필드를 제거할 수 있다.

db.inventory.find( { status: "A" }, { item: 1, status: 1, _id: 0 } )

SQL

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

Memo
: _id 필드를 제외하고 projection document에 포함 및 제외문을 결합할 수 없다.

 

제외된 field를 제외한 모든 항목 반환

일치하는 document에서 반환할 field를 나열하는 대신 projection을 사용하여 특정 필드를 제외할 수 있다.

• ex) 일치하는 document의 status: “A”에 해당하지만 status와 instock을 제외한 모든 필드를 반환한다.

 

 포함된 document의 특정 field 반환

포함된 document의 특정 field를 반환할 수 있다. dot notation(점 표기법)을 사용하여 포함된 필드를 참조하고 projection document에 1로 설정하면 된다.

• ex) 반환하는 field : _id, item, status, size의 uom

db.inventory.find(
   { status: "A" },
   { item: 1, status: 1, "size.uom": 1 }
)

Memo :
MongoDB 4.4부터 중첩 형식을 사용해 포함된 field를 지정할 수 있다.

ex) { item: 1, status: 1, size: { uom: 1 } }.

 

포함된 document에서 특정 field 억제

포함된 document에서 특정 field를 표시하지 않을 수 있다. dot notation(점 표기법)을 사용해 projection document에 포함된 필드를 참조하고 0으로 설정한다.

• ex) uom에서 size document 내부의 필드를 제외하도록 projection을 지정한다. 다른 모든 field는 일치하는 document에 반환된다.

db.inventory.find(
   { status: "A" },
   { "size.uom": 0 }
)

Memo :
MongoDB 4.4부터 중첩 형식을 사용하여 포함된 field를 지정할 수 있다.

ex) :{ size: { uom: 0 } }

 

배열에 포함된 document에 대한 projection

dot notation(점 표기법)을 사용해 포함된 document 내부의 특정 field를 projection한다.

• ex) 반환할 projection 지정 → _id, item, status, instock 배열에 포함된 qty 필드

db.inventory.find( { status: "A" }, { item: 1, status: 1, "instock.qty": 1 } )

 

 

반환된 배열의 특정 배열 요소를 projection

배열을 포함하는 field의 경우, MongoDB는 배열 조작을 위해 $eleMatch, $slice, $와 같은 프로젝션 연산자를 제공한다.

• ex) $slice projection 연산자를 사용해 instock 배열의 마지막 요소를 반환한다.

db.inventory.find( { status: "A" }, { item: 1, status: 1, instock: { $slice: -1 } } )

Memo :
$eleMatch, $slice, $는 반환된 배열에 포함한 특정 요소를 projection하는 유일한 방법이다.

배열 인덱스를 사용하여 특정 배열 요소를 투영할 수 없다.

ex) { "instock.0": 1 } projection은 첫 번째 요소가 있는 배열을 projection 하지 않는다.