Mongoose Schemas and Models Explained for Node.js

Mongoose Schemas and Models Explained for Node.js

Schemas and models are the core of Mongoose. Here is what each is and how to use them.

What a Schema Is

A schema defines the structure of documents: field names, types, validation rules, defaults, and indexes. It is the blueprint for your data, enforcing structure in a flexible NoSQL database.

What a Model Is

A model is a constructor compiled from a schema that lets you create, read, update, and delete documents. User.create, User.find, User.findByIdAndUpdate are all model methods. The model maps to a MongoDB collection.

Schema vs Model

The schema is the structure (what fields and types). The model is the tool to interact with documents of that structure (CRUD methods). You define the schema, then compile it into a model.

Defining a Schema

const userSchema = new mongoose.Schema({ name: { type: String, required: true }, email: { type: String, unique: true, required: true }, age: Number }). The schema has types, validation, and indexes.

Creating a Model

const User = mongoose.model('User', userSchema). The model name 'User' maps to a collection named 'users' (lowercased, pluralized). Use the model for all CRUD operations.

Schema Validation

Schemas can have required fields, min/max values, match patterns, and custom validators. Mongoose runs these before saving, so invalid data never reaches the database.

The Takeaway

A Mongoose schema defines the structure, types, and validation of documents. A model is compiled from a schema and provides CRUD methods to interact with documents. Define the schema, compile the model, and use the model for all operations.