マスタデータ連携を冪等に保つ方法 ── Upsertと条件付き削除

2026.08.08
マスタデータ連携を冪等に保つ方法 ── Upsertと条件付き削除

商品マスタ、取引先マスタ、店舗マスタ ── 外部から受け取って各システムに配るマスタデータは、地味ですがすべての業務データの土台です。そしてマスタ連携には独特の難しさがあります。追加だけでなく、変更と「消えるべきデータ」の掃除まで面倒を見る必要があることです。本記事では、冪等なUpsertと条件付き削除を1フローにまとめた、壊れないマスタ連携の設計を解説します。

01 マスタ連携が壊れる典型パターン

マスタ連携の事故は、だいたい決まった形をしています。再実行したら同じ商品が2行になった(重複)。廃番になった商品がいつまでも残って受注できてしまう(掃除漏れ)。掃除のつもりの削除で消しすぎた(削除事故)。どれも、追加・更新・削除という3種類の変化を場当たり的に扱った結果です。

この3つを同時に解決する設計が「冪等Upsert+条件付き削除」です。冪等とは何度実行しても結果が同じという性質のこと。マスタ連携は失敗時の再実行が前提になるため、この性質が信頼性のすべてを支えます。

02 冪等な連携でできること

  • 追加と変更をUpsertで一本化:商品コードなどのキーで「あれば更新・なければ追加」。新商品も価格改定も、同じ1つの処理で反映されます。
  • 廃番の掃除を条件付き削除で:「廃番フラグの立った行」だけを条件指定で削除。掃除もフローの一部として毎回自動で走ります。
  • 安全装置つきの削除:削除は条件必須(空のWHEREは拒否)の設計で、「全件削除してしまった」事故を仕組みで防ぎます。
  • 受け皿のテーブル自動生成:新しい連携先のテーブルは自動生成で用意でき、受け入れ準備の手間がかかりません。

03 連携の仕組み|Upsert+条件付き削除の1フロー構成

1

取得(外部からマスタを受け取る)

FTP・S3のファイルや外部システムから、最新のマスタデータを取得します。差分ファイルでも全量ファイルでも、後段の設計は同じです。

2

反映(キー指定のUpsertで流し込む)

商品コード・取引先コードをキーにUpsertします。同じファイルを二度流しても結果は変わらず、再実行を恐れる必要がなくなります。

3

掃除(条件付き削除で廃番を消す)

「廃番フラグ=真」のような明示的な条件で、消えるべき行だけを削除します。Upsertと同じフローに入れることで、反映と掃除が常にワンセットで動きます。

外部から受け取る商品・取引先マスタを冪等なUpsertで流し込み、廃番フラグの行だけを条件付き削除で掃除する1フローの構成図
構成パターン:マスタの取り込みと掃除 ── 冪等Upsert+条件付き削除(連携カタログ データ分析基盤編より)

04 Passworkでの実現方法 ── 空WHERE拒否の安全設計

PassworkのDB・DWHコネクタは、Upsert・条件付き削除・テーブル自動生成をノーコードの設定で組み合わせられます。特に削除は条件必須(空のWHEREは拒否)という安全設計になっており、設定ミスによる全件削除が構造的に起きません。マスタのように「間違えたら業務全体に波及する」データこそ、この種のガードレールが効きます。

取り込み先はDBだけでなく、kintoneやSalesforceなどのSaaSにも同じ考え方で展開できます。項目の対応付けにはAIマッピング提案が使え、マスタ項目が多くても対応表づくりの負担を抑えられます。提供元のPraztoは350社超のデータ連携・導入支援の中で、マスタ連携の設計パターンを数多く扱ってきました。

05 業務での具体的な活用例

仕入先からの商品マスタ取り込み(小売・EC)

仕入先が配布するマスタファイルを毎晩Upsertで反映し、廃番を条件削除で掃除。新商品の追加も価格改定も廃番も、翌朝には全システムに揃っています

グループ会社間の取引先マスタ統一(管理部門)

本社のマスタを各社システムへ配る構成もUpsertなら安全です。どの会社のシステムでも同じ取引先コードで会話できる状態を、日次で維持できます。

分析基盤のディメンションテーブル維持(データ分析)

DWHの商品・店舗ディメンションを業務システムから自動反映します。「分析側だけマスタが古い」ことによる集計のズレがなくなります。

06 まとめ:マスタは「何度流しても同じ」が正義

マスタデータ連携の要点は、キー指定のUpsertで追加・変更を一本化し、明示条件の削除で掃除し、全体を冪等に保つこと。この設計にしておけば、失敗しても再実行すればよく、再実行してもデータは壊れません。マスタ連携の信頼性は、担当者の注意力ではなく設計で作るものです。

この記事の構成図は「Passwork連携カタログ データ分析基盤編」からの抜粋です

マスタ連携のほか、DWHへの集約、リバースETL、Tableauデータソースの自動更新など、データ分析基盤の代表的な構成パターン10種と対応DB/DWH15種をまとめた資料を無料でダウンロードいただけます。無料でダウンロードする

データ連携の自動化 で始めませんか?

SaaS・データソース・DWHをノーコードでつなぎ、AIが連携フローの構築を支援します。
「何を・どの条件で・どこにつなぐか」の設計から、専門のコンサルタントが無料でご相談承ります。

一覧トップへ戻る
Passwork サービス紹介資料

対応コネクタと連携構成例がわかる資料

サービス概要から対応コネクタ一覧、料金プラン、活用ユースケースまでをまとめた資料を無料でダウンロードいただけます。導入検討や社内共有の資料としてぜひご活用ください。

資料をダウンロードする
無料デモを予約 30分・その場で日程確定