0Pricing
MongoDB Academy · Урок

Встраивание: связи «один с небольшим числом»

Вы встроите вложенные документы для тесно связанных данных и оцените преимущество размещения связанной информации в одном месте для скорости чтения.

«Встраивание: связи «один с небольшим числом»» — бесплатный урок MongoDB Academy на CoddyKit. Это урок 1 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения MongoDB Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс MongoDB Academy содержит 4 уроков всего.

Части этого урока еще не переведены и отображаются на английском.

What Is Document Embedding?

Embedding means storing related data directly inside a parent document rather than in a separate collection. Instead of linking two collections with a foreign key, you nest the related data as a sub-document or an array of sub-documents. This is MongoDB's most powerful design tool because it allows a single read to retrieve the parent and all its related data at once.

The One-to-Few Relationship

A one-to-few relationship exists when one parent document has a small, bounded number of child items—typically fewer than a few dozen. Classic examples include a blog post and its comments, a user and their addresses, or an order and its line items. When the child count is predictable and small, embedding is almost always the right choice.

Embedding a User's Addresses

Consider a users collection where each user has one or two delivery addresses. Instead of a separate addresses collection, embed them directly. This means finding a user and their addresses requires one query with zero joins.

db.users.insertOne({
  name: 'Alice',
  email: 'alice@example.com',
  addresses: [
    { label: 'home', street: '123 Maple St', city: 'Austin', zip: '78701' },
    { label: 'work', street: '456 Oak Ave', city: 'Austin', zip: '78702' }
  ]
});

Reading Embedded Data in One Query

When data is embedded, you retrieve the parent document and all its children with a single findOne. There is no need for a $lookup or a second round trip to the database. This makes reads faster and the application code simpler, since the entire object graph arrives in one response.

// Retrieve user AND their addresses in a single read
const user = await db.collection('users').findOne(
  { email: 'alice@example.com' },
  { projection: { name: 1, addresses: 1 } }
);
console.log(user.addresses); // Array of embedded address objects

Updating an Embedded Sub-Document

To update an embedded sub-document, use the positional operator $ or dot notation. For example, changing the zip code of Alice's home address targets the specific array element that matches a filter condition. Embedded updates happen atomically at the document level—no transaction needed.

db.users.updateOne(
  { email: 'alice@example.com', 'addresses.label': 'home' },
  { $set: { 'addresses.$.zip': '78703' } }
);

Read Performance Advantage

MongoDB stores documents as contiguous BSON blobs on disk. When you embed related data, the engine reads one block of storage instead of two separate collection scans. This co-location of related data is the core reason embedded documents outperform referencing for read-heavy workloads where the parent and children are almost always accessed together.

Embedding in Mongoose

In Mongoose, you define sub-document schemas and nest them inside the parent schema. Mongoose treats embedded arrays as sub-document arrays, providing full type validation and lifecycle hooks on each element. The parent model saves the entire tree atomically.

const addressSchema = new mongoose.Schema({
  label: String,
  street: String,
  city: String,
  zip: String
});

const userSchema = new mongoose.Schema({
  name: String,
  email: String,
  addresses: [addressSchema]  // embedded array of sub-documents
});

const User = mongoose.model('User', userSchema);

When Embedding Shines

Embedding works best when: (1) the child data is always accessed with the parent; (2) the number of children is small and bounded; (3) the children do not need their own independent lifecycle (e.g., they are never queried or updated in isolation). If all three conditions are true, embedding is almost certainly the optimal choice.

Document Size Limit

Every MongoDB document has a hard size limit of 16 MB. For one-to-few relationships, this is rarely a concern—a user with ten addresses or an order with twenty line items is well within the limit. However, you should monitor document growth over time to make sure embedding does not push documents toward the ceiling.

Embedding vs Referencing at a Glance

Use this quick comparison to guide your choice:

  • Embedding: one query, atomic updates, small bounded child count
  • Referencing: flexible child count, shared children, independent child queries

For one-to-few relationships, embedding wins on almost every metric. You avoid extra network round trips and keep your schema simple.

Practical Example: Blog Post Tags

A blog post typically has a small, fixed set of tags. Rather than maintaining a separate tags collection with references, embed the tags as an array of strings directly in the post document. Querying posts by tag is efficient with a multikey index on the tags field, and reading a post always returns its tags in the same document.

db.posts.insertOne({
  title: 'Getting Started with MongoDB',
  body: 'MongoDB is a document database...',
  tags: ['mongodb', 'nosql', 'database'],
  author: 'Alice',
  createdAt: new Date()
});

// Index the tags array for fast tag-based lookups
db.posts.createIndex({ tags: 1 });

Quick Check

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

Lesson Recap

In this lesson you learned: embedding places related data inside the parent document, one-to-few relationships benefit from embedding because a single read fetches all data, and Mongoose supports sub-document schemas for type-safe embedded arrays. Next up we explore referencing—when to link documents across collections instead of nesting them.

Часто задаваемые вопросы

Урок «Встраивание: связи «один с небольшим числом»» бесплатный?

Да — полный текст урока «Встраивание: связи «один с небольшим числом»» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс MongoDB Academy, подпишись на CoddyKit PRO. Курс MongoDB Academy содержит 4 уроков всего.

Чему я научусь в уроке «Встраивание: связи «один с небольшим числом»»?

Вы встроите вложенные документы для тесно связанных данных и оцените преимущество размещения связанной информации в одном месте для скорости чтения. Ты практикуешь MongoDB Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать MongoDB Academy?

Предыдущий опыт не требуется. MongoDB Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 1 из 4.

Сколько времени занимает урок «Встраивание: связи «один с небольшим числом»»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке MongoDB Academy?

Да. Каждый урок MongoDB Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

  1. Встраивание: связи «один с небольшим числом»
  2. Ссылки: связи «один ко многим» и «многие ко многим»
  3. Антипаттерн неограниченного массива
  4. Система принятия решений при проектировании схемы
← Назад к MongoDB Academy