Heroku Connect の重複レコードの問題

最終更新日 2022年12月01日(木)

Heroku Connect では、読み取りと書き込みに別々のスレッド​を使用します。読み取り/書き込みマッピングに一意識別子がない場合、重複したレコードが作成される可能性があります。この記事では、このような状況とそれを防ぐ方法について説明します。

シナリオ

次のような場合、重複したレコードが作成されます。

  1. Heroku Connect が新しいレコードを Salesforce に書き込みます。
  2. 書き込みスレッドが新しい Salesforce ID (sfid​) を Postgres に書き戻す前に​、別のスレッドが Postgres へのレコード再同期を開始します。
  3. 変更を Salesforce から同期するとき、Heroku Connect はその Salesforce ID によってレコードを照合しようとします。この例では Salesforce ID が使用できないため、一意外部識別子​を使用した照合にフォールバックします。sfid​ も一意外部識別子も使用できない場合、Connect は新しく、重複したレコードを Postgres に作成します。元のレコードの sfid​ は設定されないままです。

一意性の保証による重複防止

Salesforce でオブジェクトにカスタムフィールドを追加し、一意識別子​として設定します。この識別子は、重複したレコードの作成を防ぎます。さらに、設定された一意外部 ID を使用して、新しく挿入された行を外部テーブルから確実に参照することもできます。

一意識別子は Salesforce ID のエイリアスとして扱ってください。変更または再利用はせず、一意性を保証する生成メカニズムを選んでください。

Postgres の整数シーケンスは一意性が保証されないため、使用しないでください。Heroku Connect データベースの ID フィールドは一意識別子として使用しないでください。これらの数値は、設定を新しいデータベースにインポートしたり、テーブルをリロードしたりするとリセットされる可能性があります。

自動インクリメントフィールドは一意識別子に使用しないでください。

レコードを最初に INSERT​ するときに、グローバルまたはユニバーサル一意 ID (GUID または UUID) などの一意の値を、この一意識別子フィールドに設定します。この戦略によって、Postgres で新しく作成されるレコードの一意性が保証されると同時に、オブジェクト間の関係が確立されます​。gen_random_uuid()​ を使用して生成できるランダム UUID を使用することをお勧めします。

gen_random_uuid()​ の使用には pgcrypto​ 拡張機能​の有効化 (CREATE EXTENSION IF NOT EXISTS pgcrypto;​) が必要です。

再挿入されたレコード

一意識別子を使用していても、Salesforce のレコードを Heroku Connect 経由で同期した直後に削除した場合は、重複したレコードが作成される可能性があります。この状況はまれにしか発生しませんが、Salesforce のレコードを Heroku Connect 経由で同期した直後に削除することはお勧めできません。削除する前に少なくとも 10 分間は待ってください。詳細は、「再挿入されたレコード​」を参照してください。