Upsert behavior (update or insert) in MongoDB - Mini Project: Build & Apply

Upsert Behavior (Update or Insert) in MongoDB

📖 Scenario: You are managing a small online bookstore's inventory using MongoDB. You want to keep track of books and their stock counts. Sometimes you receive new books, and sometimes you get more copies of existing books. You want to write a query that updates the stock count if the book already exists, or inserts a new book if it does not.

🎯 Goal: Build a MongoDB query that uses upsert behavior to update the stock count of a book if it exists, or insert a new book document if it does not.

📋 What You'll Learn

Create a collection named books with initial book documents.

Define a filter to find a book by its title.

Write an updateOne query with upsert: true option.

Update the stock field or insert a new book document.

💡 Why This Matters

🌍 Real World

Inventory management systems often need to update existing records or add new ones seamlessly. Upsert queries help keep data accurate without extra checks.

💼 Career

Database developers and backend engineers use upsert operations to efficiently maintain data integrity and reduce code complexity.

1

Create the initial books collection with two book documents

Create a variable called books and assign it an array with two objects. The first object should have title as "The Great Gatsby" and stock as 3. The second object should have title as "1984" and stock as 5.

MongoDB

# Create the books array with two book objects
# Your code here

Hint

Use a list of dictionaries with exact keys and values as shown.

2

Define a filter to find a book by its title

Create a variable called filter and assign it an object with the key title and the value "The Great Gatsby".

MongoDB

books = [
    {'title': "The Great Gatsby", 'stock': 3},
    {'title': "1984", 'stock': 5}
]

# Define the filter object to find the book by title
# Your code here

Hint

The filter is a dictionary with the key title and the exact value.

3

Write an updateOne query with upsert: true option to update the stock

Create a variable called update and assign it an object with the key $set and value an object that sets stock to 10.

MongoDB

books = [
    {'title': "The Great Gatsby", 'stock': 3},
    {'title': "1984", 'stock': 5}
]

filter = {'title': "The Great Gatsby"}

# Create the update object to set stock to 10
# Your code here

Hint

Use the $set operator to update the stock field.

4

Complete the upsert operation with updateOne and upsert: true

Create a variable called options and assign it an object with upsert set to true. Then create a variable called result and assign it the call to db.books.updateOne(filter, update, options).

MongoDB

books = [
    {'title': "The Great Gatsby", 'stock': 3},
    {'title': "1984", 'stock': 5}
]

filter = {'title': "The Great Gatsby"}

update = {'$set': {'stock': 10}}

# Set upsert option and run updateOne query
# Your code here

Hint

Use the upsert: true option to insert if the book does not exist.

Practice

1. What does the upsert option do in a MongoDB updateOne operation?

easy

A. It only inserts a new document without updating existing ones.

B. It updates a document if it exists, or inserts a new one if it does not.

C. It deletes a document if it exists, otherwise does nothing.

D. It duplicates the document regardless of existence.

Solution

1. Step 1: Understand the upsert option

   The upsert option in MongoDB means update if found, insert if not found.

2. Step 2: Apply to updateOne operation

   When using updateOne with upsert: true, MongoDB updates the matching document or inserts a new one if none matches.

3. Final Answer:

   It updates a document if it exists, or inserts a new one if it does not. -> Option B

4. Quick Check:

   Upsert = update or insert [OK]

Hint: Upsert means update if found, else insert new [OK]

Common Mistakes:

• Thinking upsert only inserts without updating
• Confusing upsert with delete operation
• Assuming upsert duplicates documents

2. Which of the following is the correct syntax to perform an upsert using updateOne in MongoDB?

easy

A. db.collection.updateOne(filter, update, {update: true})

B. db.collection.updateOne(filter, update, {insert: true})

C. db.collection.updateOne(filter, update, {upsert: true})

D. db.collection.updateOne(filter, update, {replace: true})

Solution

1. Step 1: Recall the updateOne method parameters

   The updateOne method takes a filter, an update document, and an options object.

2. Step 2: Identify the correct option for upsert

   The option to enable upsert is {upsert: true}, which tells MongoDB to insert if no match is found.

3. Final Answer:

   db.collection.updateOne(filter, update, {upsert: true}) -> Option C

4. Quick Check:

   Use upsert: true in options [OK]

Hint: Use {upsert: true} in updateOne options [OK]

Common Mistakes:

• Using {insert: true} instead of {upsert: true}
• Omitting the options object entirely
• Confusing update with replace option

3. Given the collection users with documents:
{ _id: 1, name: "Alice", age: 25 }
What will be the result after running:

db.users.updateOne({ _id: 2 }, { $set: { name: "Bob", age: 30 } }, { upsert: true })

and then querying db.users.find().toArray()?

medium

A. [{ _id: 1, name: "Alice", age: 25 }, { _id: 2, name: "Bob", age: 30 }]

B. [{ _id: 1, name: "Alice", age: 25 }]

C. [{ _id: 2, name: "Bob", age: 30 }]

D. []

Solution

1. Step 1: Understand the updateOne with upsert

   The filter looks for _id: 2, which does not exist, so upsert inserts a new document with _id: 2 and the given fields.

2. Step 2: Check existing documents

   The original document with _id: 1 remains unchanged, so the collection now has two documents.

3. Final Answer:

   [{ _id: 1, name: "Alice", age: 25 }, { _id: 2, name: "Bob", age: 30 }] -> Option A

4. Quick Check:

   Upsert inserts missing document, keeps existing [OK]

Hint: Upsert inserts new if filter misses existing docs [OK]

Common Mistakes:

• Assuming existing documents get deleted
• Thinking upsert only updates existing documents
• Expecting only the new document after upsert

4. You run the following code but it does not insert a new document when no match is found:

db.products.updateOne({ sku: "123" }, { price: 19.99 })

What is the likely error?

medium

A. The filter syntax is incorrect and causes a syntax error.

B. MongoDB does not support upsert with updateOne.

C. The update document is missing the $set operator.

D. Missing the upsert: true option in the updateOne call.

Solution

1. Step 1: Check the updateOne parameters

   The updateOne call lacks the options object with upsert: true, so it only updates existing documents.

2. Step 2: Confirm upsert behavior

   Without upsert: true, no new document is inserted if the filter finds no match.

3. Final Answer:

   Missing the upsert: true option in the updateOne call. -> Option D

4. Quick Check:

   Upsert option needed to insert new docs [OK]

Hint: Add {upsert: true} to updateOne options to insert [OK]

Common Mistakes:

• Forgetting to add upsert option
• Confusing missing $set with upsert behavior
• Believing updateOne cannot upsert

5. You want to update the status field to "active" for a user with email: "[e-mail]". If no such user exists, insert a new document with email and status. Which MongoDB command correctly achieves this?

hard

A. db.users.updateOne({ email: "[e-mail]" }, { $set: { status: "active" } }, { upsert: true })

B. db.users.insertOne({ email: "[e-mail]", status: "active" })

C. db.users.updateOne({ email: "[e-mail]" }, { status: "active" }, { upsert: true })

D. db.users.updateMany({ email: "[e-mail]" }, { $set: { status: "active" } })

Solution

1. Step 1: Identify the correct update syntax with upsert

   To update or insert, use updateOne with a filter, an update using $set, and {upsert: true} option.

2. Step 2: Check each option

   db.users.updateOne({ email: "[e-mail]" }, { $set: { status: "active" } }, { upsert: true }) uses $set and upsert correctly. db.users.insertOne({ email: "[e-mail]", status: "active" }) only inserts, no update. db.users.updateOne({ email: "[e-mail]" }, { status: "active" }, { upsert: true }) misses $set operator, which replaces the whole document incorrectly. db.users.updateMany({ email: "[e-mail]" }, { $set: { status: "active" } }) updates many but no upsert.

3. Final Answer:

   db.users.updateOne({ email: "[e-mail]" }, { $set: { status: "active" } }, { upsert: true }) -> Option A

4. Quick Check:

   Use updateOne + $set + upsert: true [OK]

Hint: Use $set with upsert: true in updateOne to update or insert [OK]

Common Mistakes:

• Omitting $set causing document replacement
• Using insertOne which does not update
• Forgetting upsert option for insert fallback