model과 ORM은 어떻게 동작하나요?

Question

Accepted Answer

**model**은 데이터의 구조를 정의하는 Python 클래스입니다. 각 model은 데이터베이스 테이블에 매핑되고, 각 속성은 컬럼에 매핑됩니다. **ORM(Object-Relational Mapper)**은 원시 SQL을 작성하는 대신 Python 객체와 메서드를 사용해 데이터베이스와 상호작용하게 해줍니다.

## model 정의하기

```python
from django.db import models

class Article(models.Model):
    title = models.CharField(max_length=200)       # → VARCHAR 컬럼
    body = models.TextField()                        # → TEXT 컬럼
    published = models.BooleanField(default=False)
    created_at = models.DateTimeField(auto_now_add=True)  # 생성 시 설정
    views = models.IntegerField(default=0)

def __str__(self):
        return self.title                            # 읽기 좋은 표현(admin, shell)
```

각 model 필드는 적절한 타입의 데이터베이스 컬럼에 매핑됩니다. migration을 실행하면 해당 테이블이 생성됩니다. `CREATE TABLE`을 직접 작성하지 않습니다.

## ORM으로 CRUD 하기(SQL 없이)

```python
# CREATE
article = Article.objects.create(title="Hello", body="...")

# READ — Python 메서드로 쿼리
Article.objects.all()                            # 모든 행 → SELECT *
Article.objects.get(id=1)                         # 기본키로 한 행
Article.objects.filter(published=True)            # WHERE published = true
Article.objects.filter(title__icontains="django") # WHERE title ILIKE '%django%'
Article.objects.exclude(views=0).order_by("-created_at")  # 복잡한 쿼리, 체이닝

# UPDATE
article.title = "Updated"
article.save()
Article.objects.filter(published=False).update(published=True)  # 일괄 업데이트

# DELETE
article.delete()
```

ORM은 이러한 Python 호출을 자동으로 SQL로 변환합니다. 필드 룩업(`__icontains`, `__gte`, `__in` 등)은 WHERE 조건을 Python답게 표현합니다.

## 왜 ORM인가? 장점과 트레이드오프

```text
✓ 데이터베이스 코드를 Python으로 작성 — SQL 불필요, 가독성 향상, 오류 감소
✓ 데이터베이스 독립적 — 동일 코드가 PostgreSQL, MySQL, SQLite에서 동작
✓ 보안 — 기본적으로 파라미터화된 쿼리 → SQL 인젝션 방지
✓ migration, admin, form과 통합(model 한 번만 정의)
⚠️ 트레이드오프: 부주의하게 사용하면 비효율적인 쿼리(예: N+1)를 생성할 수 있음 —
   복잡한 경우 select_related/prefetch_related나 원시 SQL이 필요할 수 있음
```

## model은 단일 진실 공급원(DRY)

```text
하나의 model 정의가 구동: 데이터베이스 스키마(migration), admin 인터페이스,
ModelForm, serializer(DRF) — 한 번 정의하고 어디서나 재사용.
```

## 왜 중요한가

model과 ORM은 Django의 핵심입니다. 이를 통해 애플리케이션의 데이터를 정의하고 다루며, 데이터는 대부분 웹 애플리케이션의 심장입니다.

이를 이해하는 것은 필수적인 일상 지식입니다. model은 데이터 구조를 정의(클래스를 테이블에, 속성을 컬럼에 매핑)하며, 데이터베이스 스키마, admin 인터페이스, form, API serializer를 구동하는 **단일 진실 공급원** 역할을 합니다(DRY 철학).

ORM은 데이터베이스 작업을 깔끔하고 읽기 쉬운 **SQL 대신 Python으로** 작성하게 해주며, 주요 이점이 있습니다: 데이터베이스 이식성(동일 코드가 다른 데이터베이스에서 실행), Django의 나머지 부분과의 긴밀한 통합, 그리고 결정적으로 **보안**(기본적으로 파라미터화된 쿼리를 사용해 SQL 인젝션을 방지).

적절한 필드로 model을 정의하고, CRUD 작업을 수행하고, ORM의 룩업 문법으로 쿼리하는 방법을 아는 것은 모든 Django 애플리케이션을 구축하는 데 기초적입니다.

마찬가지로 중요한 것은 ORM의 **트레이드오프**에 대한 인식입니다. 편리한 쿼리가 주의하지 않으면 비효율적(N+1 문제)이 될 수 있으며, 이는 최적화 기법으로 이어집니다.

model/ORM 계층은 Django 애플리케이션의 로직이 많이 자리하는 곳이므로, 핵심적이고 반드시 익혀야 할 자료입니다.