Djangoにおけるデータ管理：論理削除と物理削除の適切な使い分け

2025年10月27日

Webアプリケーションを開発する際、データの「削除」は避けて通れない機能の一つです。特にDjangoのようなフレームワークを使用していると、instance.delete()メソッドで簡単にデータを削除できます。

しかし、この「削除」には、データベースからレコードを完全に消去する「物理削除（ハードデリート）」と、データは残しつつ「削除済み」として扱う「論理削除（ソフトデリート）」の2種類が存在します。

安易に論理削除を採用すると、将来的にシステムのパフォーマンスや保守性に悪影響を及ぼす可能性があります。この記事では、Djangoにおけるデータ削除の戦略について、両者の違い、実装例、そして考慮すべき点について解説します。

物理削除（ハードデリート）とは

物理削除は、データベースのテーブルから該当するレコードを完全に（物理的に）削除する操作です。SQLのDELETE文が発行され、データは復元不可能な形で消去されます。

Djangoでは、モデルインスタンスのdelete()メソッドを呼び出すと、デフォルトでこの物理削除が実行されます。

# product_item (models.Model) のインスタンス
try:
    item = InventoryItem.objects.get(sku="ITEM-001")
    # この時点でデータベースからレコードが物理的に削除される
    item.delete()
except InventoryItem.DoesNotExist:
    # 該当アイテムが存在しない場合の処理
    pass

物理削除の利点

シンプルさ: 実装が単純明快です。
ストレージ効率: 不要なデータがデータベースに残らないため、ストレージ容量を圧迫しません。
データ整合性: 削除されたデータが意図せずクエリ結果に含まれることがありません。

物理削除の欠点

不可逆性: 一度削除すると、バックアップがない限りデータを復旧できません。
監査（Audit）の困難: 「いつ、誰が削除したか」という履歴が残りません（別途ログを残す仕組みが必要）。

論理削除（ソフトデリート）とは

論理削除は、データベース上のレコードは削除せず、特定のカラム（フラグ）の状態を変更することで、アプリケーション上「削除済み」として扱う手法です。

例えば、「is_visible」といったブール（Boolean）型のカラムを用意し、通常はTrue、削除時にFalseに更新します。

Djangoでの論理削除の実装例

論理削除を安全に実装するには、デフォルトのマネージャー（objects）をカスタマイズし、通常（削除されていない）データのみを取得するようにするのが一般的です。

ここでは、InventoryItem（在庫商品）モデルを例に、is_visibleフラグを用いた論理削除を実装します。

from django.db import models
from django.utils import timezone

class InventoryItemManager(models.Manager):
    """
    論理削除を考慮したカスタムマネージャー
    """
    def get_queryset(self):
        # デフォルトで is_visible=True のアイテムのみを返す
        return super().get_queryset().filter(is_visible=True)

class InventoryItem(models.Model):
    """
    在庫商品モデル（論理削除対応）
    """
    sku = models.CharField(max_length=100, unique=True, verbose_name="商品SKU")
    name = models.CharField(max_length=255, verbose_name="商品名")
    stock_quantity = models.PositiveIntegerField(default=0, verbose_name="在庫数")
    
    # 論理削除用フラグ（デフォルトはTrue=表示）
    is_visible = models.BooleanField(default=True, db_index=True)
    # 削除（非表示）日時を記録する場合
    hidden_at = models.DateTimeField(null=True, blank=True)

    # デフォルトのマネージャー
    objects = InventoryItemManager()
    # 全てのデータ（削除済み含む）にアクセスするためのマネージャー
    all_objects = models.Manager() 

    def delete(self, using=None, keep_parents=False):
        """
        delete()メソッドをオーバーライドし、論理削除を実行する
        """
        self.is_visible = False
        self.hidden_at = timezone.now()
        self.save(using=using)

    def hard_delete(self, using=None, keep_parents=False):
        """
        物理削除を実行するためのメソッド
        """
        super().delete(using=using, keep_parents=keep_parents)

    def restore(self):
        """
        論理削除から復元する
        """
        self.is_visible = True
        self.hidden_at = None
        self.save()

    class Meta:
        verbose_name = "在庫商品"
        verbose_name_plural = "在庫商品"

カスタムマネージャーの役割

上記の例では、InventoryItemManagerを定義し、objectsマネージャーとして設定しました。

# InventoryItem.objects.all() は is_visible=True のものだけを返す
visible_items = InventoryItem.objects.all()

# 論理削除されたアイテム（is_visible=False）も含む全てを取得する場合
all_items = InventoryItem.all_objects.all()

このように設定することで、アプリケーションの大部分でInventoryItem.objectsを使用している限り、誤って「削除済み」のデータを取得・表示してしまうリスクを低減できます。