Time-series collections in MongoDB - Mini Project: Build & Apply

Create and Use a Time-Series Collection in MongoDB

📖 Scenario: You are managing a small weather station that records temperature and humidity every hour. You want to store this data efficiently using MongoDB's time-series collections.

🎯 Goal: Build a time-series collection in MongoDB to store hourly weather data with timestamps, then insert and query the data.

📋 What You'll Learn

Create a time-series collection named weatherData with time as the time field

Set the meta field to location to store the station location

Insert three sample documents with exact timestamps and values

Query the collection to find all records for the location StationA

💡 Why This Matters

🌍 Real World

Time-series collections are used in IoT, monitoring, and logging systems to efficiently store and query data that changes over time.

💼 Career

Understanding time-series collections is important for database administrators and backend developers working with real-time data and analytics.

1

Create the time-series collection

Use the db.createCollection command to create a time-series collection called weatherData with time as the time field and location as the meta field.

MongoDB

# Your code here to create the time-series collection

Hint

Use db.createCollection with the timeseries option specifying timeField and metaField.

2

Insert sample weather data

Insert three documents into weatherData with these exact fields: time (ISODate), location (string), temperature (number), and humidity (number). Use these exact values: 2024-06-01T10:00:00Z, StationA, 22.5, 60; 2024-06-01T11:00:00Z, StationA, 23.0, 58; 2024-06-01T12:00:00Z, StationA, 24.0, 55.

MongoDB

db.createCollection("weatherData", {
  timeseries: {
    timeField: "time",
    metaField: "location"
  }
})

# Your code here to insert three documents

Hint

Use insertMany with an array of documents. Use ISODate for the time field.

3

Query data for StationA

Write a query using find on weatherData to get all documents where location is exactly "StationA".

MongoDB

db.createCollection("weatherData", {
  timeseries: {
    timeField: "time",
    metaField: "location"
  }
})

db.weatherData.insertMany([
  { time: ISODate("2024-06-01T10:00:00Z"), location: "StationA", temperature: 22.5, humidity: 60 },
  { time: ISODate("2024-06-01T11:00:00Z"), location: "StationA", temperature: 23.0, humidity: 58 },
  { time: ISODate("2024-06-01T12:00:00Z"), location: "StationA", temperature: 24.0, humidity: 55 }
])

# Your code here to query documents for StationA

Hint

Use find with a filter object specifying location: "StationA".

4

Create an index on the time field

Create an index on the time field in the weatherData collection to optimize queries by time.

MongoDB

db.createCollection("weatherData", {
  timeseries: {
    timeField: "time",
    metaField: "location"
  }
})

db.weatherData.insertMany([
  { time: ISODate("2024-06-01T10:00:00Z"), location: "StationA", temperature: 22.5, humidity: 60 },
  { time: ISODate("2024-06-01T11:00:00Z"), location: "StationA", temperature: 23.0, humidity: 58 },
  { time: ISODate("2024-06-01T12:00:00Z"), location: "StationA", temperature: 24.0, humidity: 55 }
])

const stationARecords = db.weatherData.find({ location: "StationA" })

# Your code here to create an index on the time field

Hint

Use createIndex on the time field with ascending order 1.

Practice

1. What is the main purpose of a time-series collection in MongoDB?

easy

A. To manage user authentication and roles

B. To store large binary files like images and videos

C. To efficiently store and query data that changes over time

D. To create backups of the database automatically

Solution

1. Step 1: Understand time-series data

   Time-series data is data recorded over time, like temperature or stock prices.

2. Step 2: Identify MongoDB time-series collection use

   MongoDB time-series collections optimize storage and queries for such time-based data.

3. Final Answer:

   To efficiently store and query data that changes over time -> Option C

4. Quick Check:

   Time-series collections = efficient time-based data storage [OK]

Hint: Time-series collections are for data changing over time [OK]

Common Mistakes:

• Confusing time-series collections with file storage
• Thinking time-series collections manage users
• Assuming they handle backups automatically

2. Which of the following is required when creating a time-series collection in MongoDB?

easy

A. A field that stores binary data

B. A unique index on the _id field

C. A field that stores user roles

D. A field that stores the timestamp of each record

Solution

1. Step 1: Recall time-series collection requirements

   MongoDB requires a time field to track when each data point was recorded.

2. Step 2: Check other options

   Unique _id index exists by default but is not specific to time-series; user roles and binary data fields are unrelated.

3. Final Answer:

   A field that stores the timestamp of each record -> Option D

4. Quick Check:

   Time field required = A field that stores the timestamp of each record [OK]

Hint: Time field is mandatory for time-series collections [OK]

Common Mistakes:

• Choosing unrelated fields like user roles
• Confusing default indexes with required time field
• Thinking binary data field is required

3. Given the following command, what will be the result?

db.createCollection("sensorData", {
  timeseries: {
    timeField: "timestamp",
    metaField: "deviceId"
  }
})

medium

A. Creates a time-series collection with timestamp and deviceId fields

B. Throws a syntax error due to missing options

C. Creates a regular collection named sensorData

D. Creates a capped collection instead of time-series

Solution

1. Step 1: Analyze the createCollection command

   The command uses the timeseries option with timeField and metaField specified.

2. Step 2: Understand MongoDB behavior

   This creates a time-series collection named sensorData with timestamp as time and deviceId as metadata.

3. Final Answer:

   Creates a time-series collection with timestamp and deviceId fields -> Option A

4. Quick Check:

   timeseries option creates time-series collection [OK]

Hint: timeseries option creates time-series collection [OK]

Common Mistakes:

• Thinking it creates a regular or capped collection
• Assuming syntax error due to missing options
• Confusing metaField with required timeField

4. You tried to create a time-series collection but got an error. Which of the following is the most likely cause?

db.createCollection("temps", {
  timeseries: {
    metaField: "location"
  }
})

medium

A. Missing required timeField in timeseries options

B. metaField cannot be used in time-series collections

C. Collection name is invalid

D. timeseries option is misspelled

Solution

1. Step 1: Check timeseries options in the command

   The command specifies metaField but omits the required timeField.

2. Step 2: Recall MongoDB requirements

   timeField is mandatory for time-series collections; missing it causes an error.

3. Final Answer:

   Missing required timeField in timeseries options -> Option A

4. Quick Check:

   timeField missing = error [OK]

Hint: Always include timeField when creating time-series collections [OK]

Common Mistakes:

• Thinking metaField is not allowed
• Assuming collection name is invalid
• Believing timeseries option is misspelled

5. You have a time-series collection with fields timestamp (timeField) and sensorId (metaField). You want to query the average temperature for sensorId 'S1' over the last 24 hours. Which aggregation pipeline is correct?

db.sensorData.aggregate([
  { $match: { sensorId: 'S1', timestamp: { $gte: new Date(Date.now() - 86400000) } } },
  { $group: { _id: null, avgTemp: { $avg: "$temperature" } } }
])

hard

A. Groups by sensorId instead of null

B. Correctly filters by sensorId and timestamp, then averages temperature

C. Uses $sort instead of $match for filtering

D. Filters only by timestamp, ignoring sensorId

Solution

1. Step 1: Analyze the $match stage

   The pipeline filters documents where sensorId is 'S1' and timestamp is within last 24 hours.

2. Step 2: Analyze the $group stage

   It groups all matched documents (_id: null) and calculates average temperature.

3. Final Answer:

   Correctly filters by sensorId and timestamp, then averages temperature -> Option B

4. Quick Check:

   Filter by sensorId and time, then average = Correctly filters by sensorId and timestamp, then averages temperature [OK]

Hint: Match filters, group aggregates for averages [OK]

Common Mistakes:

• Forgetting to filter by sensorId
• Using $sort instead of $match for filtering
• Grouping by sensorId when only one sensor is queried