Embedded documents (nested objects) in MongoDB

Introduction

Embedded documents let you store related information inside a single record. This keeps data organized and easy to find.

When you want to keep related details together, like a person's address inside their profile.

When you want to avoid multiple database lookups by storing connected data in one place.

When the nested data is small and always used with the main document.

When you want to model real-world objects that naturally contain other objects, like a blog post with comments.

When you want to update related data in one operation.

Syntax

MongoDB

{
  field1: value1,
  nestedField: {
    subField1: value2,
    subField2: value3
  }
}

Embedded documents are like mini-records inside a main record.

You can nest documents as deep as you need, but keep it simple for easy use.

Examples

This example shows a person with an embedded address document.

MongoDB

{
  name: "Alice",
  address: {
    street: "123 Main St",
    city: "Springfield"
  }
}

Here, product details are stored inside the main product document.

MongoDB

{
  product: "Book",
  details: {
    author: "John Doe",
    pages: 250
  }
}

This example uses an array of embedded documents to list order items.

MongoDB

{
  orderId: 101,
  items: [
    { name: "Pen", qty: 3 },
    { name: "Notebook", qty: 1 }
  ]
}

Sample Program

This inserts a user with embedded contact info, then retrieves and prints it.

MongoDB

db.users.insertOne({
  name: "Bob",
  contact: {
    email: "[e-mail]",
    phone: "555-1234"
  }
});

// Find the user and show the embedded contact info
const user = db.users.findOne({ name: "Bob" });
printjson(user);

Important Notes

Embedded documents help keep related data together, making queries simpler.

Too much nesting can make documents large and slow to read or write.

Use embedded documents when the nested data is closely tied to the main document.

Summary

Embedded documents store related data inside a main document.

They make data easier to access and keep related info together.

Use them wisely to keep your database efficient and simple.

Practice

1. What is an embedded document in MongoDB?

easy

A. A document stored inside another document as a nested object

B. A separate collection linked by an ID

C. A document stored in a different database

D. A document stored as a file on disk

Solution

1. Step 1: Understand MongoDB document structure

   MongoDB stores data in documents, which can contain nested objects called embedded documents.

2. Step 2: Identify embedded document meaning

   An embedded document is a document inside another document, not a separate collection or file.

3. Final Answer:

   A document stored inside another document as a nested object -> Option A

4. Quick Check:

   Embedded document = nested object inside document [OK]

Hint: Think of a box inside another box holding related info [OK]

Common Mistakes:

• Confusing embedded documents with references
• Thinking embedded documents are separate collections
• Assuming embedded documents are stored outside the database

2. Which of the following is the correct way to insert an embedded document in MongoDB?

easy

A. db.collection.insertOne([{name: 'Alice'}, {address: {city: 'NY', zip: 10001}}])

B. db.collection.insertOne({name: 'Alice'}, {address: {city: 'NY', zip: 10001}})

C. db.collection.insertOne(name: 'Alice', address: {city: 'NY', zip: 10001})

D. db.collection.insertOne({name: 'Alice', address: {city: 'NY', zip: 10001}})

Solution

1. Step 1: Review MongoDB insertOne syntax

   insertOne takes a single document object with fields and values, including nested objects.

2. Step 2: Check each option's syntax

   db.collection.insertOne({name: 'Alice', address: {city: 'NY', zip: 10001}}) correctly nests the address object inside the main document. Others have syntax errors or wrong structure.

3. Final Answer:

   db.collection.insertOne({name: 'Alice', address: {city: 'NY', zip: 10001}}) -> Option D

4. Quick Check:

   Nested object inside one document = correct insert [OK]

Hint: Use one object with nested braces for embedded docs [OK]

Common Mistakes:

• Passing multiple objects instead of one
• Missing curly braces around nested document
• Using array instead of object for embedded document

3. Given the document { name: 'Bob', contact: { email: '[e-mail]', phone: '1234' } }, what will the query db.users.find({ 'contact.email': '[e-mail]' }) return?

medium

A. No documents, because nested fields can't be queried

B. All documents where contact.email equals '[e-mail]'

C. Documents where name equals '[e-mail]'

D. Documents where contact is exactly '[e-mail]'

Solution

1. Step 1: Understand dot notation in queries

   MongoDB uses dot notation to query fields inside embedded documents.

2. Step 2: Analyze the query

   The query looks for documents where the embedded field contact.email matches the given value.

3. Final Answer:

   All documents where contact.email equals '[e-mail]' -> Option B

4. Quick Check:

   Dot notation queries embedded fields correctly [OK]

Hint: Use dot notation to access nested fields in queries [OK]

Common Mistakes:

• Trying to match entire embedded document instead of field
• Using wrong field name without dot notation
• Assuming nested fields can't be queried

4. What is wrong with this update query to change the city in an embedded address document?
db.users.updateOne({name: 'Eve'}, {address.city: 'LA'})

medium

A. The field name should not use dot notation

B. The query filter is incorrect

C. The update document is missing the $set operator

D. updateOne cannot update embedded documents

Solution

1. Step 1: Recall updateOne syntax

   updateOne requires an update operator like $set to specify fields to change.

2. Step 2: Identify missing $set operator

   The query tries to update address.city directly without $set, which is invalid syntax.

3. Final Answer:

   The update document is missing the $set operator -> Option C

4. Quick Check:

   Updates need $set for field changes [OK]

Hint: Always use $set to update fields, including nested ones [OK]

Common Mistakes:

• Forgetting $set in update document
• Using dot notation incorrectly in filter
• Thinking updateOne can't change nested fields

5. You want to store multiple phone numbers inside a user's document using embedded documents. Which schema design is best?

hard

A. { name: 'Sam', phones: [{ type: 'home', number: '111' }, { type: 'work', number: '222' }] }

B. { name: 'Sam', phone1: '111', phone2: '222' }

C. { name: 'Sam', phones: { home: '111', work: '222' } }

D. { name: 'Sam', phones: '111,222' }

Solution

1. Step 1: Understand storing multiple embedded documents

   To store multiple related items, use an array of embedded documents for flexibility and clarity.

2. Step 2: Compare options

   { name: 'Sam', phones: [{ type: 'home', number: '111' }, { type: 'work', number: '222' }] } uses an array of objects with type and number, which is clear and scalable. Others are less flexible or harder to query.

3. Final Answer:

   { name: 'Sam', phones: [{ type: 'home', number: '111' }, { type: 'work', number: '222' }] } -> Option A

4. Quick Check:

   Array of embedded docs best for multiple related items [OK]

Hint: Use arrays of objects for multiple related embedded documents [OK]

Common Mistakes:

• Storing multiple values as comma-separated string
• Using separate fields for each phone number
• Using a single object without array for multiple items