UPSERT（INSERT ON CONFLICT）とは何ですか？

Question

Accepted Answer

**UPSERT** は「挿入、またはすでに存在していれば更新」を意味します。PostgreSQL はこれを **`INSERT ... ON CONFLICT`** で実装しています — 行を挿入しますが、ユニーク制約に違反する場合は、代わりに既存の行を更新します（または何もしません）。これは一般的な「挿入または更新」の必要性をアトミックに処理します。

## UPSERT が解決する問題

```text
You want to insert a row, but it might already exist (by a unique key):
  ❌ a plain INSERT fails with a unique-violation error if it exists
  ❌ check-then-insert (SELECT, then INSERT or UPDATE) has a RACE CONDITION
     (another transaction could insert between your check and insert)
→ ON CONFLICT does it atomically in ONE statement (no race condition)
```

## ON CONFLICT DO UPDATE — 挿入または更新

```sql
INSERT INTO users (email, name, login_count)
VALUES ('ann@x.com', 'Ann', 1)
ON CONFLICT (email)                  -- if a row with this email already exists...
DO UPDATE SET                        -- ...UPDATE it instead
  name = EXCLUDED.name,              -- EXCLUDED = the values you tried to insert
  login_count = users.login_count + 1;  -- can reference the existing row too
```

挿入が `email` ユニーク制約で競合する場合、Postgres は代わりに既存の行を更新します。**`EXCLUDED`** は挿入を試みた値を参照し、既存の行（`users.login_count`）も参照できます — これにより、カウンターをインクリメントするようなロジックが可能になります。

## ON CONFLICT DO NOTHING — 挿入またはスキップ

```sql
INSERT INTO users (email, name) VALUES ('ann@x.com', 'Ann')
ON CONFLICT (email) DO NOTHING;      -- if it exists, just skip (no error)
```

`DO NOTHING` は競合する行を静かにスキップします — エラーなく「存在しなければ挿入」する場合に便利です。

## よくある実例：カウンターとべき等挿入

```sql
-- track page views — insert on first view, increment on subsequent
INSERT INTO page_views (page_id, views) VALUES (5, 1)
ON CONFLICT (page_id) DO UPDATE SET views = page_views.views + 1;
```

## なぜ重要なのか

UPSERT（`INSERT ... ON CONFLICT`）は重要で、実用的価値の高い PostgreSQL の機能です。これは非常に一般的な「挿入または更新」の必要性をクリーンで**安全**に解決するため、理解することは実世界のデータ操作に有用です。

その必要性 — すでに存在している可能性のある行を挿入する（ユニークキーによって） — は頻繁に発生します（レコードのアップサート、カウンター、べき等挿入、データの同期など）。素朴な代替案には問題があります：単純な INSERT は行が存在する場合、エラーで失敗し、check-then-insert アプローチ（SELECT してから INSERT-or-UPDATE）には**競合状態**があります（別の同時実行トランザクションがチェックと挿入の間に挿入される可能性があり、エラーや更新の喪失を引き起こします）。`ON CONFLICT` はこれを**単一ステートメントでアトミックに**解決します — 競合状態を排除し、これが同時実行アプリケーションの重要な正確性の利点です。

両方の形式を理解する — **`DO UPDATE`**（挿入または更新、`EXCLUDED` は試みた値を参照し、既存の行を参照する能力でカウンターのインクリメントのようなロジックを可能にする）と **`DO NOTHING`**（挿入またはスキップを静かに行う） — は一般的なパターン（レコードのアップサート、べき等挿入、カウンター/集計の維持）をカバーしています。

挿入または更新は頻繁な操作であり、それを正しく安全に行う（アトミックに、競合状態なく）ことは同時実行アプリケーションのデータ整合性にとって重要であるため、UPSERT — それが解決すること、アトミック性/競合状態の利点、DO UPDATE/DO NOTHING の形式 — を理解することは、価値のある、頻繁に適用される PostgreSQL の知識です。これは、そうでなければエラーが起きやすい一般的な必要性に対してクリーンで安全なソリューションを提供し、実際のアプリケーションにとって実用的で重要な機能です。