MongoDB Academy · 강의

중첩 및 배열 필드 프로젝션

점 표기법과 $slice 연산자를 사용하여 배열과 중첩 하위 문서의 일부를 프로젝션합니다.

중첩 및 배열 필드 프로젝션은(는) CoddyKit의 무료 MongoDB Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 MongoDB Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. MongoDB Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

이 강의의 일부는 아직 번역되지 않았으며 영어로 표시됩니다.

Projecting Nested Fields With Dot Notation

To project a specific field from an embedded sub-document, use dot notation in the projection key. For example, if a document has an address sub-document, you can project only address.city without returning the full address object. MongoDB traverses the nested path and returns only the specified leaf field, keeping the parent field wrapper in the result.

// Document shape: { name, address: { street, city, zip }, email }
const user = await db.collection('users').findOne(
  { email: 'alice@example.com' },
  { projection: { name: 1, 'address.city': 1, _id: 0 } }
);
// Result: { name: 'Alice', address: { city: 'Austin' } }
// street and zip are excluded; only city is returned inside address

Excluding Nested Fields

Just as with top-level fields, you can exclude specific nested fields while returning the rest of the sub-document. Using 'address.zip': 0 returns the entire address object except the zip field. This is useful for hiding internal-use sub-fields while exposing the rest of a nested object to the client.

// Return everything except address.zip
const user = await db.collection('users').findOne(
  { email: 'alice@example.com' },
  { projection: { 'address.zip': 0, passwordHash: 0 } }
);
// Result includes address.street and address.city but not address.zip

Array Fields in Projections

When a projected field is an array, MongoDB returns the entire array by default. If a user document has a tags array with ten elements, projecting tags: 1 returns all ten. To control how much of an array is returned, you need $slice, $, or $elemMatch—the three array-specific projection operators.

// Returns the entire tags array
const post = await db.collection('posts').findOne(
  { slug: 'intro-to-mongodb' },
  { projection: { title: 1, tags: 1, _id: 0 } }
);
// Result: { title: '...', tags: ['mongodb', 'nosql', 'tutorial', ...] }

Slicing Arrays With $slice

The $slice projection operator limits the number of array elements returned. Pass a positive integer to return the first N elements, or a negative integer to return the last N elements. You can also pass a two-element array [skip, limit] to skip a number of elements and then return the next N. $slice is the simplest way to paginate or preview array contents.

// Return only the first 3 comments from a post
db.posts.findOne(
  { slug: 'intro-to-mongodb' },
  { projection: { title: 1, comments: { $slice: 3 } } }
);

// Return the last 5 comments
db.posts.findOne(
  { slug: 'intro-to-mongodb' },
  { projection: { title: 1, comments: { $slice: -5 } } }
);

// Skip 10 comments, then return the next 5
db.posts.findOne(
  { slug: 'intro-to-mongodb' },
  { projection: { title: 1, comments: { $slice: [10, 5] } } }
);

Projecting Nested Array Sub-Fields

You can project a field inside an array of sub-documents using dot notation in an inclusion projection. For example, an orders document might have an items array where each element has productId, qty, and price. Projecting 'items.qty': 1 returns the entire items array but with only the qty field inside each element.

// Return items array with only the qty field in each element
db.orders.findOne(
  { _id: ObjectId('o1') },
  { projection: { 'items.qty': 1, 'items.productId': 1, _id: 0 } }
);
// Result:
// { items: [{ productId: ObjectId('p1'), qty: 2 }, { productId: ObjectId('p2'), qty: 1 }] }

Excluding a Nested Array Sub-Field

Similarly, you can exclude specific sub-fields from array elements. For example, an employees collection might store salary inside a compensation sub-document within each element of an array. Projecting 'positions.compensation': 0 returns the positions array with the sensitive compensation data stripped from each element.

// Exclude compensation from every element of the positions array
db.employees.findOne(
  { name: 'Alice' },
  { projection: { 'positions.compensation': 0 } }
);

Projecting Multiple Nested Paths

You can project multiple nested fields from the same sub-document or array in one projection. Each dot-notation path is independent. This composability lets you extract precisely the sub-tree of a document that your query needs, without bringing back irrelevant nested data that would inflate the response.

// Get shipping address city and order total only
db.orders.find(
  { status: 'shipped' },
  {
    projection: {
      'shippingAddress.city': 1,
      'shippingAddress.country': 1,
      total: 1,
      _id: 0
    }
  }
);

Deeply Nested Dot Notation

Dot notation can go multiple levels deep. If you have a document with meta.seo.keywords, you can project exactly that path. MongoDB will return the outer wrapper fields (meta and seo) but only include the keywords leaf, stripping all other sibling fields at each level.

// Document: { title, meta: { seo: { keywords: [...], description: '...' }, author: '...' } }
db.articles.findOne(
  { slug: 'my-article' },
  { projection: { title: 1, 'meta.seo.keywords': 1, _id: 0 } }
);
// Result: { title: '...', meta: { seo: { keywords: [...] } } }
// meta.seo.description and meta.author are excluded

Projection and Index Coverage for Nested Fields

For a query to be covered (served entirely from the index without touching documents), the projection must include only fields present in the index, including nested fields. A compound index on { 'address.city': 1, name: 1 } can cover a query that filters on address.city and projects only address.city and name (with _id: 0). Covered queries achieve the lowest possible latency.

// Create an index on nested field
db.users.createIndex({ 'address.city': 1, name: 1 });

// Covered query — both filter and projection are inside the index
db.users.find(
  { 'address.city': 'Austin' },
  { projection: { 'address.city': 1, name: 1, _id: 0 } }
).explain('executionStats');
// totalDocsExamined should be 0

$slice in Mongoose

Mongoose does not have a native $slice shorthand on the query builder, but you can pass a projection object directly. Use { fieldName: { $slice: N } } inside the Mongoose .select() call if you pass an object, or pass the projection as the second argument to .find(). The driver forwards it to MongoDB unchanged.

// Mongoose: return title and first 5 comments using $slice
const post = await Post.findOne(
  { slug: 'intro-to-mongodb' },
  { title: 1, comments: { $slice: 5 }, _id: 0 }
);

// Alternatively as a Mongoose query
const post2 = await Post
  .findOne({ slug: 'intro-to-mongodb' })
  .select({ title: 1, comments: { $slice: 5 }, _id: 0 });

Nested Projection Gotchas

A common gotcha: projecting a nested field in an array requires you to use dot notation, but MongoDB returns the full array wrapper. You cannot project individual array elements by index (e.g., items.0 doesn't filter to just the first element in the projection—use $slice: 1 for that). Also, you cannot mix projecting a parent field and a child field in the same path: either project address or address.city, not both.

Quick Check

Test your understanding of MongoDB & NoSQL Databases concepts from this lesson.

Lesson Recap

In this lesson you learned: dot notation projects specific nested fields from sub-documents and arrays, $slice limits the number of array elements returned, and projecting nested array sub-fields includes only the specified leaf inside each array element. Next up we explore the $ and $elemMatch array projections for returning a single matching element from an array.

자주 묻는 질문

“중첩 및 배열 필드 프로젝션” 강의는 무료인가요?

네 — “중첩 및 배열 필드 프로젝션” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 MongoDB Academy 강의 전체를 잠금 해제할 수 있습니다. MongoDB Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“중첩 및 배열 필드 프로젝션”에서 뭘 배우나요?

점 표기법과 $slice 연산자를 사용하여 배열과 중첩 하위 문서의 일부를 프로젝션합니다. 브라우저에서 직접 실행하는 실습 코드로 MongoDB Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

MongoDB Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 MongoDB Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.

“중첩 및 배열 필드 프로젝션” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 MongoDB Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 MongoDB Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← MongoDB Academy(으)로 돌아가기