Django Model, Migration과 Admin

Model은 웹 애플리케이션의 데이터를 구조화하고 조작하기 위한 도구다. 저장할 데이터의 필드와 동작을 정의하며, 일반적으로 모델 하나가 DB 테이블 하나에 매핑된다. 기본 DB는 SQLite다.

모델과 DB는 클래스 = 테이블, 클래스 속성 = 열(column), 인스턴스 = 행(row) 으로 대응한다. PK는 따로 정의하지 않으면 Django가 자동 증가 id를 만든다.

모델 작성

# articles/models.py
from django.db import models
 
class Article(models.Model):              # django.db.models.Model 상속
    title = models.CharField(max_length=10)
    content = models.TextField()
    created_at = models.DateTimeField(auto_now_add=True)
    updated_at = models.DateTimeField(auto_now=True)
 
    def __str__(self):
        return self.title

클래스 속성 하나하나가 테이블의 열에 매핑된다.

필드	설명
`CharField(max_length=...)`	길이 제한이 있는 문자열. `max_length` 필수이며 DB 제약과 Django 유효성 검사에 모두 쓰인다
`TextField()`	길이 제한 없는 긴 텍스트. `max_length`를 줘도 폼 위젯(textarea)에만 반영되고 DB에는 적용되지 않는다
`DateTimeField(auto_now_add=True)`	최초 생성 시각. 처음 insert될 때만 기록
`DateTimeField(auto_now=True)`	최종 수정 시각. `save()`할 때마다 갱신
`IntegerField`, `BooleanField`, `ForeignKey` …	숫자, 불리언, 관계 등

Migration

Migration은 모델의 변경 사항을 DB 스키마에 반영하는 방법이다. 모델을 "설계도"로 만든 뒤 실제 DB에 적용하는 두 단계를 거친다.

python manage.py makemigrations      # 모델 변경 → 설계도(migrations/0001_initial.py) 생성
python manage.py migrate             # 설계도를 실제 DB에 적용 (모델과 스키마 동기화)
python manage.py sqlmigrate articles 0001   # 설계도가 어떤 SQL로 실행될지 미리 보기
python manage.py showmigrations      # 각 설계도의 적용 여부 확인 ([X] = 적용됨)

sqlmigrate 출력 예:

BEGIN;
CREATE TABLE "articles_article" (
  "id" integer NOT NULL PRIMARY KEY AUTOINCREMENT,
  "title" varchar(10) NOT NULL,
  "content" text NOT NULL
);
COMMIT;

테이블 이름은 기본적으로 앱이름_모델이름(소문자)이 된다.

기존 데이터가 있는 테이블에 필드 추가

이미 행이 있는 테이블에 NOT NULL 필드(예: created_at)를 추가하면 makemigrations가 기존 행에 넣을 기본값을 묻는다.

1을 선택해 지금 기본값을 입력하겠다고 답한다.
프롬프트에서 엔터를 누르면 제안된 timezone.now가 기본값으로 쓰인다.
migrate로 반영한다.

생성된 migration 파일은 버전 관리에 포함하고, 이미 적용된 파일은 함부로 수정·삭제하지 않는다.

모델 → DB API

모델을 정의하면 Django가 Article.objects(Manager)를 붙여 CRUD용 QuerySet API를 자동으로 만든다. 사용법은 Django ORM과 QuerySet에 있다.

Admin으로 데이터 확인하기

django.contrib.admin은 모델을 등록하기만 하면 목록·생성·수정·삭제 화면을 자동으로 만든다. 레코드가 제대로 생기는지 확인하거나 테스트 데이터를 넣을 때 쓴다. 로그인·권한은 django.contrib.auth를 쓴다.

python manage.py createsuperuser   # 관리자 계정 생성 → runserver 후 /admin 접속

# articles/admin.py
from django.contrib import admin
from .models import Article
 
@admin.register(Article)              # = admin.site.register(Article, ArticleAdmin)
class ArticleAdmin(admin.ModelAdmin):
    list_display = ('pk', 'title', 'created_at')   # 목록에 보일 열

`ModelAdmin` 옵션	효과
`list_display`	목록 화면에 보일 필드
`list_filter`	오른쪽 필터 사이드바
`search_fields`	검색창 대상 필드
`ordering`	기본 정렬
`readonly_fields`	수정 불가 필드

흔한 실수: ModelAdmin 클래스를 정의만 하고 register(Article)처럼 모델만 넘기면 설정이 적용되지 않는다. list_display에 없는 필드 이름을 쓰면 시스템 체크 오류(admin.E108)가 난다. 옵션 전체는 ModelAdmin options.

핵심 정리

모델 클래스 = 테이블, 클래스 속성 = 열, 인스턴스 = 행.
모델을 바꾸면 항상 makemigrations → migrate.
auto_now_add는 생성 시각, auto_now는 수정 시각.
관리자 페이지는 createsuperuser → @admin.register(Model) + ModelAdmin 옵션.

버그 제보