MongoDB Academy · 강의

포함 및 제외 프로젝션 비교

쿼리 결과에서 특정 필드를 선택하거나 숨기고, 하나의 프로젝션에서 포함과 제외를 함께 사용할 수 없는 이유를 이해합니다.

레슨 1/413개 단계

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

프로젝션이란 무엇인가요?

프로젝션은 find() 또는 findOne()의 두 번째 인수로, 결과에 포함하거나 제외할 필드를 MongoDB에 지정합니다. 문서 전체를 반환하는 대신 필요한 필드만 정확히 지정할 수 있습니다. 이렇게 하면 네트워크 대역폭과 애플리케이션의 메모리 사용량이 줄어들고 API 응답을 간결하게 유지할 수 있습니다. 프로젝션은 사용할 수 있는 가장 간단하면서도 효과가 큰 쿼리 최적화 방법 중 하나입니다.

포함 모드: 반환할 항목 지정

포함 모드에서는 받을 필드를 나열하고 해당 필드의 값을 1로 설정합니다. MongoDB는 해당 필드와 함께 기본적으로 포함되는 _id만 반환합니다. 쿼리가 의존하는 필드를 명시적으로 선언하므로 코드를 읽는 사람이 의도를 쉽게 이해할 수 있어 가장 일반적으로 사용되는 프로젝션 방식입니다.

// Return only name and email — everything else is excluded
const user = await db.collection('users').findOne(
  { email: 'alice@example.com' },
  { projection: { name: 1, email: 1 } }
);
// Result: { _id: ObjectId('...'), name: 'Alice', email: 'alice@example.com' }

결과에서 _id 제외하기

_id 필드는 명시적으로 제외하지 않는 한 포함 프로젝션에 항상 포함됩니다. 이를 제외하려면 포함할 필드와 함께 _id: 0을 설정합니다. 다른 식별자 필드를 사용하는 API 응답을 만들거나 MongoDB의 내부 ID가 클라이언트에 노출되는 것을 방지하려는 경우에 유용합니다.

// Include name and email but suppress _id
const user = await db.collection('users').findOne(
  { email: 'alice@example.com' },
  { projection: { _id: 0, name: 1, email: 1 } }
);
// Result: { name: 'Alice', email: 'alice@example.com' }
// _id is not present

제외 모드: 생략할 항목 지정

제외 모드에서는 필드를 0으로 설정하여 결과에서 제거합니다. 나머지 모든 필드는 반환됩니다. 대부분의 필드는 필요하지만 민감하거나 크기가 큰 몇 개의 필드만 숨기려는 경우에 유용합니다. 예를 들어 일반적인 사용자 쿼리의 결과에서 passwordHash 필드를 숨길 수 있습니다.

// Return all user fields EXCEPT passwordHash and internalNotes
const user = await db.collection('users').findOne(
  { email: 'alice@example.com' },
  { projection: { passwordHash: 0, internalNotes: 0 } }
);
// Result: everything except passwordHash and internalNotes

포함과 제외를 함께 사용할 수 없음

MongoDB에서는 하나의 프로젝션에 포함 필드(1)와 제외 필드(0)를 함께 사용할 수 없습니다. 단, _id 필드는 예외입니다. 이렇게 사용하면 Projection cannot have a mix of inclusion and exclusion fields 오류가 발생합니다. 쿼리마다 한 가지 모드만 선택해야 합니다. 허용되는 유일한 조합은 포함 필드(1)와 _id: 0입니다.

// VALID: inclusion mode with _id suppressed
{ projection: { name: 1, email: 1, _id: 0 } }

// VALID: exclusion mode
{ projection: { passwordHash: 0, secret: 0 } }

// INVALID: mixing 1 and 0 (throws an error)
// { projection: { name: 1, passwordHash: 0 } }  <- ERROR

find()와 집계에서의 프로젝션

find()에서는 프로젝션이 두 번째 인수입니다. 집계 파이프라인에서는 $project 단계를 사용하며, 이 단계는 동일한 포함 및 제외 구문뿐 아니라 계산된 필드와 표현식도 지원합니다. 포함과 제외를 함께 사용할 수 없다는 규칙은 두 방식에서 동일하게 적용되지만, $project는 필드 이름을 바꾸고 계산된 값을 추가할 수 있어 더 강력합니다.

// find() projection
db.users.find({}, { name: 1, email: 1, _id: 0 });

// Equivalent in aggregation with $project
db.users.aggregate([
  { $project: { name: 1, email: 1, _id: 0 } }
]);

프로젝션과 인덱스만으로 처리되는 쿼리

인덱스만으로 처리되는 쿼리란 필터 필드와 프로젝션 필드가 모두 하나의 인덱스 안에 포함된 쿼리입니다. MongoDB는 디스크에서 실제 문서를 읽지 않고 인덱스만으로 이러한 쿼리에 응답할 수 있습니다. 프로젝션은 인덱스만으로 처리되는 쿼리에 필수적입니다. 인덱스에 없는 필드를 프로젝션하면 MongoDB가 문서를 가져와야 하므로 이점이 사라집니다.

// Index on { email: 1, name: 1 }
db.users.createIndex({ email: 1, name: 1 });

// Covered query — filter + projection both satisfied by the index
db.users.find(
  { email: 'alice@example.com' },
  { name: 1, email: 1, _id: 0 }  // _id must be excluded for full coverage
).explain('executionStats');
// Look for 'totalDocsExamined: 0' in the output

Mongoose에서의 프로젝션

Mongoose에서는 프로젝션 문자열이나 객체를 .select()에 전달할 수 있습니다. 포함에는 +, 제외에는 -를 사용하는 공백 구분 문자열이 일반적으로 사용됩니다. 스키마에서 select: false로 표시된 필드(예: passwordHash)는 기본적으로 결과에서 제외되며, +passwordHash를 사용해 명시적으로 포함해야 합니다.

// Mongoose: string projection (+ include, - exclude)
const users = await User.find({}).select('name email -_id');

// Object projection
const user = await User.findOne({ email: 'a@b.com' }).select({ name: 1, email: 1, _id: 0 });

// Schema-level default exclusion
const userSchema = new mongoose.Schema({
  email: String,
  passwordHash: { type: String, select: false }  // excluded by default
});

프로젝션의 성능상 이점

프로젝션은 세 가지 방식으로 성능을 향상합니다. (1) 프로젝션이 인덱스와 일치하면 디스크에서 읽는 데이터의 양을 줄입니다. (2) MongoDB 서버와 애플리케이션 사이에서 사용되는 네트워크 대역폭을 줄입니다. (3) 애플리케이션이 쿼리 결과를 보관하기 위해 할당해야 하는 메모리 양을 줄입니다. 문서가 크거나 처리량이 높은 API에서는 프로젝션으로 응답 크기를 80% 이상 줄일 수 있습니다.

집계에서 계산된 값 프로젝션하기

집계의 $project 단계는 단순한 포함 및 제외를 넘어서는 기능을 제공합니다. 표현식을 사용해 새 필드를 계산할 수 있습니다. 예를 들어 문자열을 연결하거나, 산술 연산을 수행하거나, 날짜의 일부를 추출할 수 있습니다. 이를 통해 결과를 애플리케이션으로 보내기 전에 서버에서 문서의 구조를 변환할 수 있으므로 클라이언트 측 처리를 줄일 수 있습니다.

db.orders.aggregate([
  {
    $project: {
      orderId: '$_id',
      _id: 0,
      totalWithTax: { $multiply: ['$subtotal', 1.1] },  // computed field
      year: { $year: '$createdAt' }                       // date extraction
    }
  }
]);

민감한 필드는 항상 프로젝션에서 제외하기

일반적인 쿼리에서 passwordHash, apiKey, ssn, creditCardNumber와 같은 민감한 필드를 절대 반환하지 마십시오. 제외 프로젝션이나 스키마 수준의 select: false를 사용하여 이러한 필드가 API 응답에 실수로 포함되지 않도록 하십시오. 심층 방어란 애플리케이션이 이미 응답에서 이러한 필드를 제거하더라도 데이터 계층에서 안전망으로 프로젝션을 적용하는 것을 의미합니다.

빠른 확인

이 단원에서 배운 MongoDB 및 NoSQL 데이터베이스 개념을 이해했는지 확인해 보십시오.

인터랙티브 레슨에서 답해보세요

단원 요약

이 단원에서는 다음을 배웠습니다. 포함 프로젝션(값 1)은 나열된 필드만 반환합니다. 제외 프로젝션(값 0)은 나열된 필드를 제외한 모든 필드를 반환합니다. 또한 포함 필드와 _id: 0을 함께 사용하는 경우를 제외하면 포함과 제외를 함께 사용할 수 없습니다. 다음으로는 점 표기법과 $slice를 사용하여 중첩 필드와 배열을 프로젝션하는 방법을 살펴봅니다.

무료로 시작

AI 튜터와 함께 JavaScript을(를) 배우세요 — 무료

브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.

코스: 30
레슨: 120

무료로 학습 시작 전체 코스 보기

자주 묻는 질문

“포함 및 제외 프로젝션 비교” 강의는 무료인가요?

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

“포함 및 제외 프로젝션 비교”에서 뭘 배우나요?

쿼리 결과에서 특정 필드를 선택하거나 숨기고, 하나의 프로젝션에서 포함과 제외를 함께 사용할 수 없는 이유를 이해합니다. 브라우저에서 직접 실행하는 실습 코드로 MongoDB Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

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

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

“포함 및 제외 프로젝션 비교” 강의는 얼마나 걸리나요?

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

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

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

이 강의의 모든 강의

← MongoDB Academy(으)로 돌아가기