Model là lớp Python mô tả bảng dữ liệu. Django tạo bảng từ model thông qua migration. Bài này tạo model Member và làm việc với SQLite mặc định.
- Khai báo model và kiểu trường
- Tạo và chạy migration
- Xem SQL được sinh ra
- Thêm trường mới
Cơ sở lý thuyết
ORM (Object-Relational Mapping – ánh xạ đối tượng–quan hệ) cho phép làm việc với CSDL quan hệ bằng lớp và đối tượng Python thay vì viết SQL: mỗi lớp model là một bảng, mỗi thuộc tính là một cột, mỗi đối tượng là một dòng.
| Kiểu trường | Cột SQL tương ứng |
|---|---|
| CharField(max_length) | VARCHAR |
| IntegerField, DecimalField | INT, DECIMAL |
| DateField, DateTimeField | DATE, DATETIME |
| BooleanField | BOOLEAN |
| ForeignKey | Khóa ngoại – quan hệ nhiều–một |
| ManyToManyField | Bảng trung gian – quan hệ nhiều–nhiều |
- Migration là "hệ thống quản lý phiên bản cho lược đồ CSDL": makemigrations so sánh model với trạng thái trước và sinh tệp mô tả thay đổi; migrate áp dụng lên CSDL. Tệp migration được đưa vào Git để mọi máy có cùng cấu trúc.
- on_delete quy định hành vi khi bản ghi cha bị xóa: CASCADE (xóa theo), PROTECT (chặn xóa), SET_NULL.
- Ràng buộc toàn vẹn: unique, choices, validators, Meta.constraints (UniqueConstraint, CheckConstraint).
- Lệnh sqlmigrate xem câu SQL thực sự được sinh ra.
Khai báo model
# members/models.py
from django.db import models
class Member(models.Model):
firstname = models.CharField(max_length=255)
lastname = models.CharField(max_length=255)
phone = models.CharField(max_length=20, null=True, blank=True)
joined_date = models.DateField(null=True)
def __str__(self):
return f"{self.firstname} {self.lastname}"Migration
python manage.py makemigrations members # tạo tệp migration
python manage.py sqlmigrate members 0001 # xem SQL
python manage.py migrate # tạo bảng trong CSDLKiểu trường thường dùng
| Trường | Dữ liệu |
|---|---|
| CharField | Chuỗi ngắn (cần max_length) |
| TextField | Văn bản dài |
| IntegerField, FloatField, DecimalField | Số |
| DateField, DateTimeField | Ngày, ngày giờ |
| BooleanField | Đúng/sai |
| ForeignKey | Khóa ngoại tới model khác |
| EmailField, SlugField, ImageField | Dữ liệu có kiểm tra định dạng |
Ứng dụng thực tế
Bài toán: mô hình hóa quản lý đồ án tốt nghiệp: mỗi đồ án có một sinh viên thực hiện, một giảng viên hướng dẫn, nhiều thành viên hội đồng; điểm từ 0 đến 10; mỗi sinh viên chỉ có một đồ án mỗi năm học:
# do_an/models.py
from django.db import models
from django.core.validators import MinValueValidator, MaxValueValidator
class GiangVien(models.Model):
ho_ten = models.CharField(max_length=100)
hoc_vi = models.CharField(max_length=20, choices=[("ThS", "Thạc sĩ"), ("TS", "Tiến sĩ")])
def __str__(self): return self.hoc_vi + ". " + self.ho_ten
class DoAn(models.Model):
ten_de_tai = models.CharField(max_length=300)
sinh_vien = models.ForeignKey("SinhVien", on_delete=models.PROTECT, related_name="do_an")
huong_dan = models.ForeignKey(GiangVien, on_delete=models.PROTECT, related_name="huong_dan")
hoi_dong = models.ManyToManyField(GiangVien, related_name="hoi_dong", blank=True)
nam_hoc = models.CharField(max_length=9) # "2026-2027"
diem = models.DecimalField(max_digits=4, decimal_places=2, null=True, blank=True,
validators=[MinValueValidator(0), MaxValueValidator(10)])
class Meta:
constraints = [models.UniqueConstraint(fields=["sinh_vien", "nam_hoc"], name="mot_do_an_moi_nam")]python manage.py makemigrations do_an
python manage.py sqlmigrate do_an 0001 # xem SQL được sinh
python manage.py migrateMỗi lần sửa models.py phải chạy lại makemigrations và migrate; không sửa tay bảng trong CSDL.
- Tạo model Member như ví dụ và chạy migrate.
- Thêm trường email, tạo migration mới.
- Mở tệp db.sqlite3 bằng DB Browser for SQLite để xem bảng.
- Model = lớp Python ↔ bảng CSDL.
- makemigrations rồi migrate.
- __str__ giúp hiển thị đối tượng dễ đọc.

