ORMでリレーションシップをどのようにモデル化しますか?

Question

Accepted Answer

DjangoのORMは、3つの基本的なデータベースリレーションシップを専用のフィールドタイプでモデル化します。**ForeignKey**（1対多）、**ManyToManyField**（多対多）、**OneToOneField**（1対1）です。これらはテーブル間の関係を定義し、関連するオブジェクトへのPythonic的なアクセスを可能にします。

## ForeignKey — 1対多（最も一般的）

```python
class Author(models.Model):
    name = models.CharField(max_length=100)

class Book(models.Model):
    title = models.CharField(max_length=200)
    author = models.ForeignKey(
        Author,
        on_delete=models.CASCADE,        # what happens if the author is deleted
        related_name="books",            # access the reverse: author.books
    )
```

```python
# access related objects naturally:
book.author                # the Author this book belongs to (forward)
author.books.all()         # all Books by this author (reverse, via related_name)
```

`ForeignKey`は「多くの書籍が1人の著者に属する」をモデル化しています。`on_delete`の動作（`CASCADE`、`PROTECT`、`SET_NULL`など）は**必須**であり、著者が削除された場合に書籍に対して何が起こるかを定義します。

## ManyToManyField — 多対多

```python
class Article(models.Model):
    title = models.CharField(max_length=200)
    tags = models.ManyToManyField("Tag", related_name="articles")   # many tags ↔ many articles

class Tag(models.Model):
    name = models.CharField(max_length=50)
```

```python
article.tags.add(tag1, tag2)        # associate tags
article.tags.all()                   # all tags on this article
tag.articles.all()                   # all articles with this tag (reverse)
```

Djangoは`ManyToManyField`の背後で**結合テーブル**を自動的に作成します。`.add()`、`.remove()`、`.all()`を使用するだけです。（リレーションシップに追加データが必要な場合は、`through`モデルを使用してください。）

## OneToOneField — 1対1

```python
class User(models.Model):
    username = models.CharField(max_length=50)

class Profile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE)   # one profile per user
    bio = models.TextField()
```

`OneToOneField`は厳密な1対1のリンクを強制します。通常、モデルを拡張する場合に使用されます（例：Userを拡張したProfile）。

## on_deleteオプション（正しく選択することが重要）

```text
CASCADE   → delete related objects too (delete author → delete their books)
PROTECT   → prevent deletion if related objects exist (raises an error)
SET_NULL  → set the FK to NULL (requires null=True) — keep the books, orphan them
SET_DEFAULT / SET(...) → set to a default/computed value
RESTRICT  → similar to PROTECT, with nuances
```

## リレーションシップをまたがるクエリ

```python
# traverse relationships in queries with __ (double underscore)
Book.objects.filter(author__name="Tolkien")        # books whose author's name is Tolkien
Article.objects.filter(tags__name="python")         # articles tagged 'python'
```

## なぜ重要なのか

リレーションシップを正しくモデル化することは、Djangoで関連データを操作する際の基本です。ほぼすべての実用的なアプリケーションには関連エンティティ（ユーザーと投稿、注文と商品、記事とタグ）があるため、3つのリレーションシップフィールドタイプを理解することは日々不可欠な知識です。

いつ各フィールドを使用するかを知ること — **ForeignKey**を1対多に使用（最も一般的で、著者に属する書籍のような場合）、**ManyToManyField**を多対多に使用（記事とタグのような場合で、Djangoが結合テーブルを自動管理）、**OneToOneField**を1対1に使用（プロフィールでユーザーを拡張するような場合）— は、重要でないデータモデルを設計するために必須です。

ORMは関連データを**Pythonic で便利に**します（`book.author`と`author.books.all()`に自然にアクセスでき、`__`を使ってリレーションシップをまたがるクエリができます）。しかし、2つの側面には注意が必要です。正しい**`on_delete`の動作**を選択すること（必須で重要な判断 — `CASCADE`は関連オブジェクトを削除し、`PROTECT`は削除を防ぎ、`SET_NULL`はそれらを孤立させます。間違えるとデータの不意な損失や整合性エラーが発生します）、そして明確な逆方向アクセスのために`related_name`を使用することです。

リレーションシップモデリング、on_deleteオプション、リレーションシップをまたがるクエリの理解は、正確で適切に設計されたDjangoデータモデルを構築するための中核であり、クエリの最適化に直結しています（リレーションシップをたどる場合、無分別な方法ではN+1問題が発生するため）。これは基礎的で頻繁にテストされる知識です。