Watch method for real-time updates in MongoDB

Introduction

The watch method lets you see changes in your database as they happen. It helps you react quickly without checking over and over.

You want to update a chat app instantly when someone sends a message.

You need to refresh a dashboard when new data arrives.

You want to notify users immediately when their order status changes.

You want to keep multiple users' views in sync in real time.

You want to log changes as soon as they happen for auditing.

Syntax

MongoDB

const changeStream = collection.watch(pipeline, options);
changeStream.on('change', (change) => {
  // handle change event
});

collection.watch() starts watching changes on a collection.

You can add a pipeline to filter which changes to watch.

Examples

Watch all changes in the 'messages' collection and print them.

MongoDB

const changeStream = db.collection('messages').watch();
changeStream.on('change', (change) => {
  console.log('Change detected:', change);
});

Watch only new inserts in the 'orders' collection.

MongoDB

const pipeline = [
  { $match: { operationType: 'insert' } }
];
const changeStream = db.collection('orders').watch(pipeline);
changeStream.on('change', (change) => {
  console.log('New order:', change.fullDocument);
});

Sample Program

This program connects to a MongoDB database called 'shop' and watches the 'orders' collection for new orders. When a new order is added, it prints the order details immediately.

MongoDB

const { MongoClient } = require('mongodb');

async function watchOrders() {
  const client = new MongoClient('mongodb://localhost:27017');
  await client.connect();
  const db = client.db('shop');
  const orders = db.collection('orders');

  const changeStream = orders.watch([
    { $match: { operationType: 'insert' } }
  ]);

  console.log('Watching for new orders...');

  changeStream.on('change', (change) => {
    console.log('New order received:', change.fullDocument);
  });
}

watchOrders();

Important Notes

The watch method requires MongoDB replica sets or sharded clusters.

Remember to close the change stream when done to avoid resource leaks.

You can watch at database or cluster level too, not just collections.

Summary

The watch method helps you get real-time updates from your database.

You can filter which changes to watch using a pipeline.

It is useful for apps that need instant reactions to data changes.

Practice

1. What is the main purpose of the watch method in MongoDB?

easy

A. To backup the database automatically

B. To create indexes on collections

C. To listen for real-time changes in the database

D. To delete documents in bulk

Solution

1. Step 1: Understand the watch method's role

   The watch method is designed to monitor changes in the database as they happen.

2. Step 2: Compare with other options

   Backup, indexing, and deleting are unrelated to real-time monitoring.

3. Final Answer:

   To listen for real-time changes in the database -> Option C

4. Quick Check:

   watch method = real-time updates [OK]

Hint: Remember: watch means 'listen' for changes [OK]

Common Mistakes:

• Confusing watch with backup or indexing
• Thinking watch deletes data
• Assuming watch modifies data

2. Which of the following is the correct way to start watching changes on a collection named orders in MongoDB?

easy

A. db.orders.watch()

B. db.orders.listen()

C. db.orders.observe()

D. db.orders.track()

Solution

1. Step 1: Recall the correct method name

   The method to watch changes is watch(), not listen, observe, or track.

2. Step 2: Apply method to collection

   Calling watch() on db.orders is the correct syntax.

3. Final Answer:

   db.orders.watch() -> Option A

4. Quick Check:

   Correct method is watch() [OK]

Hint: watch() is the exact method name to monitor changes [OK]

Common Mistakes:

• Using listen(), observe(), or track() which don't exist
• Forgetting parentheses after watch
• Calling watch on the database instead of collection

3. Given the following code snippet, what will be the output when a new document is inserted into the users collection?

const changeStream = db.users.watch();
changeStream.on('change', (change) => {
  console.log(change.operationType);
});

medium

A. 'insert'

B. 'update'

C. 'delete'

D. No output

Solution

1. Step 1: Understand the event listener

   The code listens for any change event on the users collection and logs the operationType.

2. Step 2: Identify the operation type for insertion

   When a new document is inserted, the operationType is insert.

3. Final Answer:

   'insert' -> Option A

4. Quick Check:

   Insert triggers operationType 'insert' [OK]

Hint: Insert operationType is 'insert' in change events [OK]

Common Mistakes:

• Expecting 'update' or 'delete' for insert events
• Thinking no output occurs without explicit fetch
• Confusing operationType with full document

4. Identify the error in this MongoDB watch usage:

const changeStream = db.products.watch({ fullDocument: 'updateLookup' });
changeStream.on('change', (change) => {
  console.log(change.fullDocument);
});

medium

A. The watch method does not accept an object as argument

B. The options should be passed as the second argument, not as the first argument object

C. fullDocument option should be set to 'default', not 'updateLookup'

D. The on method is not valid for change streams

Solution

1. Step 1: Check watch method parameters

   The watch method accepts an optional array pipeline as the first argument, not an object with options.

2. Step 2: Understand where options go

   Options like fullDocument should be passed as the second argument, not inside the pipeline array.

3. Final Answer:

   The options should be passed as the second argument, not as the first argument object -> Option B

4. Quick Check:

   Pipeline is array, options are separate [OK]

Hint: Pass pipeline as array, options as separate object [OK]

Common Mistakes:

• Passing options as first argument instead of second
• Using invalid values for fullDocument
• Misusing event handlers on change streams

5. You want to watch only update operations on the messages collection and get the full updated document in real-time. Which code snippet correctly achieves this?

hard

A. db.messages.watch([{ $match: { operationType: 'update' } }])

B. db.messages.watch({ operationType: 'update' }, { fullDocument: 'default' })

C. db.messages.watch([{ $match: { operationType: 'update' } }], { fullDocument: 'default' })

D. db.messages.watch([{ $match: { operationType: 'update' } }], { fullDocument: 'updateLookup' })

Solution

1. Step 1: Filter for update operations

   Use a pipeline with $match to watch only update operation types.

2. Step 2: Get full updated document

   Set fullDocument option to 'updateLookup' to receive the full document on update.

3. Step 3: Verify correct syntax

   Pass the pipeline array as first argument and options object as second argument to watch.

4. Final Answer:

   db.messages.watch([{ $match: { operationType: 'update' } }], { fullDocument: 'updateLookup' }) -> Option D

5. Quick Check:

   Pipeline filter + fullDocument 'updateLookup' = db.messages.watch([{ $match: { operationType: 'update' } }], { fullDocument: 'updateLookup' }) [OK]

Hint: Use $match pipeline and fullDocument: 'updateLookup' option [OK]

Common Mistakes:

• Passing options as first argument instead of second
• Using fullDocument: 'default' which doesn't guarantee full doc on update
• Not filtering operationType in pipeline