Django Basic App Model - Makemigrations and Migrate

Introduction to Django App Models and Migrations

Django is a powerful Python web framework that simplifies the process of building and managing web applications. One of its standout features is the way it handles database interactions using models and migrations. This blog explains how to define a basic model and use the makemigrations and migrate commands to apply database changes.

Creating a Django App

After setting up a Django project, the next step is to create an app where your core functionality will live. You can create a new app using:

python manage.py startapp blog

This command generates the necessary files and folder structure to begin developing features for your application.

Defining a Basic Model

Models in Django are Python classes that map to database tables. Let’s define a simple Post model in the models.py file of the app:

from django.db import models

class Post(models.Model):
    title = models.CharField(max_length=100)
    content = models.TextField()
    published = models.DateTimeField(auto_now_add=True)

Each attribute in the class corresponds to a column in the database. Django provides a wide range of field types like CharField, TextField, and DateTimeField to handle different kinds of data.

Registering the App

Before using the model, ensure the app is added to your project’s settings. Open settings.py and add the app name in the INSTALLED_APPS list:

INSTALLED_APPS = [
    ...
    'blog',
]

Running Makemigrations

After defining models, you need to generate migration files that describe the changes to be made in the database. Use the following command:

python manage.py makemigrations

This command creates migration scripts in your app's migrations directory. These scripts are not applied to the database yet—they simply represent the changes you've made in your models.

Applying Migrations

To actually implement the changes in your database, run the migrate command:

python manage.py migrate

This applies all unapplied migrations, creating or updating the relevant database tables based on your model definitions.

Checking Migration Status

If you ever want to see the current status of migrations for each app, use:

python manage.py showmigrations

This shows which migrations have been applied and which are still pending.

Conclusion

Django Basic App Model – Makemigrations and Migrate walks you through a foundational part of Django development. Understanding how to define models and manage migrations is essential for working with databases in a clean, maintainable way. With just a few commands, Django handles all the heavy lifting behind the scenes.