ON CONFLICT / ON DUPLICATE KEYによるUpsert

Upsertによる冪等Bulkインサート

Upsert（INSERTまたはUPDATE）はBulkインポートを冪等にします — 何度実行しても同じ結果が得られます。ツールはダイアレクト固有のUpsert構文を生成します。

PostgreSQL：ON CONFLICT DO UPDATE

INSERT INTO "products" ("sku", "name", "price", "stock")
VALUES
  ('SKU-001', 'Laptop', 999.99, 50),
  ('SKU-002', 'Mouse', 29.99, 200),
  ('SKU-003', 'Monitor', 599.99, 30)
ON CONFLICT ("sku") DO UPDATE SET
  "name" = EXCLUDED."name",
  "price" = EXCLUDED."price",
  "stock" = EXCLUDED."stock";

EXCLUDED擬似テーブルは、挿入しようとした値へのアクセスを提供します。

MySQL：ON DUPLICATE KEY UPDATE

INSERT INTO \`products\` (\`sku\`, \`name\`, \`price\`, \`stock\`)
VALUES
  ('SKU-001', 'Laptop', 999.99, 50),
  ('SKU-002', 'Mouse', 29.99, 200)
ON DUPLICATE KEY UPDATE
  \`name\` = VALUES(\`name\`),
  \`price\` = VALUES(\`price\`),
  \`stock\` = VALUES(\`stock\`);

MySQLはVALUES(column_name)で提案された値を参照します。

使い方

1. ON CONFLICTオプションを「Upsert (DO UPDATE)」に設定
2. コンフリクトカラムを選択（通常はプライマリキーまたはユニーク制約カラム）
3. その他すべてのカラムがUPDATE SET句にリストされます

Upsertを使うべきとき

• データ同期: 既存レコードを含む可能性のある外部ソースからデータをインポート
• 冪等スクリプト: 安全に再実行できる移行スクリプト
• 増分インポート: 既存レコードと重複する日次データフィード