Mongoose의 populate 명령어: MongoDB 관계형 데이터 처리의 핵심

Mongoose의 populate 명령어란?

mongoose의 populate 명령어는 MongoDB에서 관계형 데이터를 효과적으로 처리하기 위해 제공되는 기능입니다. 이를 사용하면 참조된 문서의 데이터를 자동으로 불러올 수 있습니다. populate는 일반적으로 ref 필드와 함께 사용되며, 이 필드는 한 문서에서 다른 문서를 참조하는 관계를 정의합니다.

---

사용 목적

MongoDB는 기본적으로 관계형 데이터베이스가 아니기 때문에, 컬렉션 간의 데이터 참조는 객체 ID(ObjectId)를 통해 이루어집니다. 그러나 참조된 데이터를 함께 가져오고 싶을 때, populate를 사용하면 이러한 데이터를 효율적으로 병합하여 조회할 수 있습니다.

---

기본 사용법

1. Schema 설계

ref 필드를 사용하여 다른 컬렉션을 참조하도록 설정합니다.

const mongoose = require('mongoose');

const AuthorSchema = new mongoose.Schema({
  name: String,
});

const BookSchema = new mongoose.Schema({
  title: String,
  author: {
    type: mongoose.Schema.Types.ObjectId,
    ref: 'Author', // 참조할 컬렉션 이름
  },
});

const Author = mongoose.model('Author', AuthorSchema);
const Book = mongoose.model('Book', BookSchema);

2. 데이터 생성

참조된 데이터를 먼저 생성한 후, 참조 필드에 해당 데이터의 _id를 저장합니다.

(async () => {
  const author = await Author.create({ name: 'J.K. Rowling' });
  const book = await Book.create({ title: 'Harry Potter', author: author._id });
})();

3. populate를 사용한 데이터 조회

populate를 사용하여 참조된 데이터를 함께 조회할 수 있습니다.

(async () => {
  const book = await Book.findOne({ title: 'Harry Potter' }).populate('author');
  console.log(book);
  // 결과:
  // {
  //   title: 'Harry Potter',
  //   author: {
  //     _id: 'authorId',
  //     name: 'J.K. Rowling'
  //   }
  // }
})();

---

고급 사용법

1. 여러 필드 populate

여러 필드를 한 번에 populate할 수 있습니다.

const result = await Book.find()
  .populate('author')
  .populate('publisher'); // 여러 필드 참조

2. 중첩된 참조 populate

중첩된 참조 데이터를 가져올 때는 다음과 같이 사용합니다.

const result = await Book.findOne({ title: 'Harry Potter' }).populate({
  path: 'author',
  populate: { path: 'profile' }, // 중첩된 참조
});

3. 선택적 필드 반환

참조된 문서에서 특정 필드만 가져오도록 설정할 수 있습니다.

const book = await Book.findOne({ title: 'Harry Potter' }).populate({
  path: 'author',
  select: 'name', // name 필드만 반환
});

4. 조건부 populate

match 옵션을 사용하여 특정 조건을 만족하는 경우에만 참조 데이터를 가져옵니다.

const books = await Book.find().populate({
  path: 'author',
  match: { name: 'J.K. Rowling' },
});

---

주의사항

1. 성능 문제: populate는 추가적인 데이터베이스 쿼리를 발생시키므로, 과도한 사용은 성능에 영향을 미칠 수 있습니다. 필요한 경우, aggregation 파이프라인을 고려해볼 수 있습니다.
2. 스키마 간 관계 관리: ref 필드가 없는 경우, populate는 제대로 동작하지 않습니다.
3. 데이터 무결성 관리: 참조된 문서가 삭제되면 _id만 남게 됩니다. 이를 처리하기 위해 적절한 데이터 정리가 필요합니다.

---

요약

Mongoose의 populate는 관계형 데이터베이스의 조인(join)과 유사한 기능을 제공합니다. 이를 활용하면 MongoDB에서도 참조 데이터를 효율적으로 조회할 수 있으며, 여러 고급 옵션을 통해 유연한 데이터 처리가 가능합니다.