Чим відрізняється embed- від reference-зв’язку в MongoDB?

Повне пояснення

Що це і навіщо

• Embed (вбудований) – один документ містить інший як вкладений об’єкт. Це корисно, коли дані логічно належать одне одному і змінюються разом.
• Reference (посилання) – документ зберігає лише ObjectId іншого документа. Підходить, коли дані спільно використовуються або мають великий розмір.

Ключові принципи

• Atomicity: embed‑зв’язок гарантує атомарність оновлень, бо всі дані зберігаються в одному документі.
• Consistency: reference‑зв’язок потребує додаткових запитів (populate) для отримання повної інформації.
• Scalability: embed‑зв’язок обмежується розміром документа (16 MiB), reference‑зв’язок не має такого обмеження.

Як це працює

• При embed‑зв’язку MongoDB просто зберігає вкладений JSON‑об’єкт.
• При reference‑зв’язку зберігається ObjectId, а для отримання повної структури потрібен lookup або populate у Mongoose.

Практика й реалізація

// Embed example (Mongoose)
const orderSchema = new Schema({
  items: [{ productId: ObjectId, quantity: Number }]
});

// Reference example (Mongoose)
const orderSchema = new Schema({
  items: [{ type: ObjectId, ref: 'Product' }]
});

Тестування

• Для embed‑зв’язку можна перевіряти, що оновлення одного документа не викликає додаткових запитів.
• Для reference‑зв’язку тестують populate і перевіряють, що ObjectId валідний.

Оптимізація запитів

• Embed‑зв’язок мінімізує кількість запитів, але збільшує розмір документа.
• Reference‑зв’язок дозволяє індексувати ObjectId, що пришвидшує пошук.

Безпека

• Обидва типи підлягають захисту через рольові права MongoDB. Reference‑зв’язок допомагає обмежити доступ до окремих колекцій.

Особливості в контексті MongoDB

• При embed‑зв’язку важливо враховувати розмір документа; при reference‑зв’язку — кількість lookup‑операцій.
• Для масштабування часто використовують reference‑зв’язок з шардингом.

Часті помилки

1. Перевантаження документа embed‑зв’язком → перевищення 16 MiB.
2. Відсутність індексу на ObjectId → повільний populate.
3. Неправильне використання ref → помилки типу "cannot resolve reference".
4. Оновлення вкладеного документа без save → зміни не зберігаються.
5. Використання embed‑зв’язку для великих списків → збільшує час читання.
6. Reference‑зв’язок без populate → повертається лише ObjectId.
7. Необхідність транзакцій при оновленні кількох документів → ризик неконсистентності.
8. Відсутність lean() у Mongoose → зайві об’єкти в пам’яті.

Cheatsheet

• Embed: швидкий доступ, атомарність, обмеження розміру.
• Reference: масштабованість, індексація, потребує populate.
• Вибір: embed для «один‑до‑много» з невеликими даними; reference для «багато‑до‑багатьох» або великих наборів.