find 쿼리와 projection은 어떻게 동작하나요?

Question

Accepted Answer

**`find`** 메서드는 필터에 일치하는 document를 가져오고, **projection**은 어떤 field를 반환할지 제어합니다. 둘을 함께 사용하면 올바른 document를 쿼리하고 출력을 형성할 수 있어 데이터를 효율적으로 읽는 데 근본적입니다.

## find — document 쿼리

```js
db.users.find();                          // 모든 document
db.users.find({ age: { $gt: 25 } });      // 필터: 일치하는 document (CURSOR)
db.users.findOne({ email: "ann@x.com" }); // 첫 번째 일치 document (또는 null)

// find는 메서드를 체이닝할 수 있는 CURSOR를 반환
db.users.find({ active: true })
  .sort({ name: 1 })                      // 정렬
  .limit(10)                              // 제한
  .skip(20);                              // 건너뛰기 (페이지네이션)
```

`find`는 `sort`, `limit`, `skip` 등으로 체이닝할 수 있는 **cursor**(결과에 대한 포인터)를 반환합니다. `findOne`은 단일 document를 직접 반환합니다.

## Projection — 반환할 field 선택

```js
// projection: 1 = 포함, 0 = 제외
db.users.find({ active: true }, { name: 1, email: 1 });        // name과 email만 (+ _id)
db.users.find({}, { password: 0 });                           // password를 제외한 전체
db.users.find({}, { name: 1, _id: 0 });                       // name만, _id 제외
```

**Projection**(두 번째 인자)은 반환되는 field를 제어합니다. `1`은 포함, `0`은 제외입니다. `_id`는 기본적으로 포함됩니다(`_id: 0`으로 제외). 일반적으로 포함과 제외를 섞을 수 없습니다(`_id`는 예외).

## projection이 중요한 이유: 효율성과 보안

```text
✓ 효율성 — 필요한 field만 반환 → 전송 데이터 감소(특히 큰 document나 큰 결과 집합)
  → 더 빠름
✓ 보안 — 민감한 field(비밀번호, 내부 데이터)를 제외하여 유출 방지
  → 예: user 데이터를 반환할 때 항상 password field를 projection으로 제외
```

## 중첩 및 배열 field projection

```js
db.users.find({}, { "address.city": 1 });        // 중첩 field (점 표기법)
db.posts.find({}, { comments: { $slice: 5 } });   // 배열의 첫 5개 요소
```

## 왜 중요한가

`find`와 projection은 MongoDB에서 **데이터를 읽는** 데 근본적입니다. 올바른 document를 쿼리하고 출력을 형성하는 것은 끊임없이 필요하므로, 이를 이해하는 것은 필수적인 일상 지식입니다.

`find`가 어떻게 동작하는지(일치하는 document의 cursor를 반환하며 정렬/페이지네이션을 위해 `sort`/`limit`/`skip`으로 체이닝 가능)와 `findOne`(단일 document)을 아는 것은 데이터 읽기의 기초입니다. **Projection**은 두 가지 실질적 이유로 특히 중요합니다. **효율성**(필요한 field만 반환하여 전송 데이터를 줄임 — 큰 document나 결과 집합에서 유의미하며 성능을 개선)과 특히 **보안**(비밀번호나 내부 데이터 같은 민감한 field를 제외하여 쿼리 결과에서 유출되지 않게 함 — 흔하고 중요한 관행으로, 예를 들어 user 데이터를 반환할 때 항상 password field를 제외하는 것으로 API의 응답 모델 사용과 유사)입니다.

field를 포함(`1`)하거나 제외(`0`)하는 방법, `_id`가 기본적으로 포함된다는 점, 중첩/배열 field를 projection하는 방법을 이해하면 쿼리 결과의 실질적 형성을 다룰 수 있습니다.

데이터 읽기는 가장 흔한 데이터베이스 연산이고, projection이 있는 `find`가 올바른 field를 가진 올바른 document를 효율적이고 안전하게 가져오는 방식이므로, find 쿼리와 projection — cursor 모델, 정렬/페이지네이션을 위한 체이닝, 특히 효율성과 보안(민감 데이터 제외)을 위한 projection — 을 이해하는 것은 모든 데이터 읽기 코드에 필수적이고 자주 적용되는 MongoDB 지식이며, 민감 field를 projection으로 제외하는 보안 측면이 특히 중요한 실질적 고려사항입니다.