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.

45 phútCơ bản
Bạn sẽ học được
  • 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ườngCột SQL tương ứng
CharField(max_length)VARCHAR
IntegerField, DecimalFieldINT, DECIMAL
DateField, DateTimeFieldDATE, DATETIME
BooleanFieldBOOLEAN
ForeignKeyKhóa ngoại – quan hệ nhiều–một
ManyToManyFieldBả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 CSDL

Kiểu trường thường dùng

TrườngDữ liệu
CharFieldChuỗi ngắn (cần max_length)
TextFieldVăn bản dài
IntegerField, FloatField, DecimalFieldSố
DateField, DateTimeFieldNgày, ngày giờ
BooleanFieldĐúng/sai
ForeignKeyKhóa ngoại tới model khác
EmailField, SlugField, ImageFieldDữ 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 migrate
Lưu ý

Mỗ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.

Thực hành
  1. Tạo model Member như ví dụ và chạy migrate.
  2. Thêm trường email, tạo migration mới.
  3. Mở tệp db.sqlite3 bằng DB Browser for SQLite để xem bảng.
Tóm tắt bài học
  • Model = lớp Python ↔ bảng CSDL.
  • makemigrations rồi migrate.
  • __str__ giúp hiển thị đối tượng dễ đọc.