Django에서 데이터베이스 트랜잭션은 어떻게 동작하나요?

Question

Accepted Answer

**데이터베이스 트랜잭션**은 여러 작업을 묶어 **모두 성공하거나 모두 함께 실패**하게 합니다(원자성)—부분적이고 일관성 없는 업데이트를 방지합니다. Django는 작업을 트랜잭션으로 감싸는 `transaction.atomic`을 제공하여, 다단계 작업의 데이터 무결성을 보장합니다.

## 트랜잭션이 해결하는 문제

```python
# ❌ 트랜잭션 없이 — 부분 실패가 일관성 없는 데이터를 남김
def transfer_money(from_account, to_account, amount):
    from_account.balance -= amount
    from_account.save()                  # ✓ 성공
    # ...여기서 서버가 충돌하면, 한 계정에서 돈이 사라짐...
    to_account.balance += amount
    to_account.save()                    # ✗ 실행 안 됨 → 돈이 사라짐!
```

트랜잭션 없이 두 번째 작업이 실패하면 첫 번째는 이미 커밋되어, 데이터베이스를 깨지고 일관성 없는 상태로 남깁니다(돈은 출금되었지만 입금되지 않음).

## transaction.atomic — 전부 아니면 전무

```python
from django.db import transaction

# 컨텍스트 매니저로
def transfer_money(from_account, to_account, amount):
    with transaction.atomic():           # 내부의 모든 것이 하나의 트랜잭션
        from_account.balance -= amount
        from_account.save()
        to_account.balance += amount
        to_account.save()
    # 어떤 작업이든 예외를 일으키면, 전체 블록이 롤백됨
    # → 두 저장이 모두 일어나거나, 둘 다 일어나지 않음(원자성)
```

```python
# 또는 전체 함수/view에 데코레이터로
@transaction.atomic
def create_order(request):
    order = Order.objects.create(...)
    for item in items:
        OrderItem.objects.create(order=order, ...)
    # 전부 아니면 전무: 어디서든 실패하면 전체 주문 생성이 롤백됨
```

`atomic()` 내부에서 어떤 작업이든 예외를 일으키면, Django는 블록의 모든 변경을 **롤백**합니다—따라서 데이터베이스는 절대 절반만 업데이트되지 않습니다. 성공하면 모든 변경이 함께 커밋됩니다.

## 중첩 atomic 블록(savepoint)

```python
with transaction.atomic():               # 외부 트랜잭션
    do_something()
    try:
        with transaction.atomic():       # 내부 = SAVEPOINT
            risky_operation()
    except Exception:
        pass                              # 내부는 savepoint로 롤백; 외부는 계속
```

중첩 `atomic` 블록은 savepoint를 사용합니다—내부 블록은 전체 외부 트랜잭션을 중단하지 않고 독립적으로 롤백할 수 있습니다.

## 중요한 세부사항

```text
✓ atomic 블록 밖에서 예외를 잡을 것(내부에서 잡으면 롤백 처리가 깨질 수 있음)
✓ select_for_update()는 트랜잭션 내에서 행을 잠금(업데이트의 경쟁 상태 방지)
    with transaction.atomic():
        account = Account.objects.select_for_update().get(pk=id)  # 커밋까지 행 잠김
✓ ATOMIC_REQUESTS 설정은 모든 요청을 트랜잭션으로 감쌈(데이터베이스별)
✓ 트랜잭션을 짧게 유지 — 긴 트랜잭션은 잠금을 보유하여 동시성을 해침
```

## 왜 중요한가

데이터베이스 트랜잭션은 작업이 함께 성공하거나 실패해야 하는 여러 관련 데이터베이스 변경을 포함할 때마다 **데이터 무결성**에 필수적이며, `transaction.atomic`을 이해하는 것은 올바르고 신뢰할 수 있는 애플리케이션을 구축하는 데 중요한 지식입니다.

트랜잭션이 해결하는 핵심 문제는 **부분 실패**입니다: 원자성 없이 다단계 작업이 중간에 실패하면(충돌, 예외, 제약 위반), 데이터베이스가 일관성 없는 상태로 남습니다—고전적인 송금 예시(한 계정에서 출금했지만 다른 계정에 입금되지 않음)는 이것이 데이터를 손상시키고 심각한 결과를 낳을 수 있음을 보여줍니다. `transaction.atomic`은 작업이 **전부 아니면 전무**(어떤 실패에서든 전체 블록을 롤백)라는 보장을 제공하며, 이는 여러 쓰기에 걸친 작업—라인 항목과 함께 주문 생성, 자금 이체, 관련 레코드 업데이트—이 일관된 데이터베이스를 유지하는 데 필요합니다.

atomic 블록을 사용하는 방법(컨텍스트 매니저 또는 데코레이터로), savepoint를 사용한 중첩 트랜잭션, 그리고 중요한 세부사항—블록 *밖*에서 예외 잡기, 동시 업데이트의 경쟁 상태를 방지하기 위해 행을 잠그는 **`select_for_update()`** 사용, 잠금 보유를 피하기 위해 트랜잭션을 짧게 유지—을 이해하는 것은 견고한 애플리케이션을 구축하는 실용 지식입니다.

데이터 일관성은 신뢰할 수 있는 시스템의 근본 요구사항이고, 트랜잭션은 다단계 데이터베이스 작업에 대해 이를 보장하는 메커니즘이므로, 이는 올바르고 무결성을 보존하는 코드를 작성하는 개발자와 실패 조건이나 동시 접근에서 조용히 데이터를 손상시킬 수 있는 애플리케이션을 만드는 개발자를 구분하는 중요한 주제입니다—중요하고 관련된 데이터 변경을 다루는 모든 애플리케이션에서 자주 관련되는 관심사입니다.