マッピング状態のリファレンス

この記事の英語版に更新があります。ご覧の翻訳には含まれていない変更点があるかもしれません。

最終更新日 2022年12月13日(火)

マッピング状態とは、Salesforce から読み取って Heroku Postgres に書き込む同期操作のステータスを指します。マッピング状態は、Heroku Connect ダッシュボード​、CLI​、または API​ を使用して確認できます。

Salesforce への書き込みは接続レベルで行われ、これらの操作はマッピング状態に反映されません。詳細は、Heroku Connect を使用した Salesforce へのデータの書き込み​を参照してください。

マッピング状態のリスト

Connect API または CLI プラグインから返される状態 Connect ダッシュボードでのステータス 説明
DATA_SYNCED​ OK 最後のポーリング以降にすべての行が同期されています。
INITIAL 作成中 Heroku Connect は、新しいマッピング用のデータベーステーブルを作成中です。
RESYNC​ 新しい列の読み込み中 Heroku Connect は、マッピングの作成に続いてデータのクエリと読み込みを実行中です。このプロセスは、既存のマッピングに新しいフィールドを追加した後にも行われます。
RELOAD_TABLE​ リロード中 Connect は、テーブルの初期ロードまたはリロードを実行中です。リロードは、手動でトリガーされた​とき、または新しいマッピングが作成されたときに実行されます。
SCHEMA_CHANGED​ DB スキーマの変更中 Heroku Connect は、マッピング設定の変更に続いてデータベーススキーマを変更しています。マッピングがこの状態でスタックしているように見える場合は、Heroku Connect mapping is stuck in ‘Altering DB schema’ status​(Heroku Connect マッピングが「DB スキーマの変更中」ステータスでスタックしている) を参照してください。
POLLING_SF_CHANGES​ SF ポーリング中 Connect は、SOAP API を使用して変更について Salesforce をポーリングしていて、その変更を Heroku Postgres に書き込んでいます。同期する変更が 10,000 を超える場合、ポーリングは Bulk API に切り替わり、マッピングは POLLING_SF_BULK​ 状態になります。
POLLING_SF_BULK​ SF ポーリング中 [一括] Connect は、Bulk API を使用して変更について Salesforce をポーリング中です。
POLLING_SF_FOR_DELETES​ SF ポーリング中 [削除] Connect は、削除されたレコードについて Salesforce をポーリング中です。
WAIT_BULK_LOAD​ 一括ジョブの待機中 Connect は、Salesforce で一括ジョブが完了するのを待機中です。この状態は、LOADING_BULK_JOB​ に先行します。後続の更新ではなくデータの初期ロードまたはリロードに関連する一括ジョブを反映することを除いて、WAIT_BULK_LOAD​ は WAIT_BULK_UPDATE​ と同義です。
LOADING_BULK_JOB​ ロード中 [一括] Connect は、Salesforce の完了済みの一括バッチからデータを取得し、そのデータを Heroku Postgres にロードしています。後続の更新ではなくデータの初期ロードまたはリロードに関連する一括ジョブを反映することを除いて、LOADING_BULK_JOB​ は APPLYING_BULK_UPDATE​ と同義です。
RESOLVE_EXTERNAL_IDS​ 外部 ID を解決中 Heroku Connect は、Postgres に設定する外部 ID を Salesforce に照会しています。マッピングに外部 ID 関係フィールドが含まれている場合、この操作は一括ロードの適用後に実行されます。後続の更新ではなくデータの初期ロードまたはリロードに関連する一括ジョブを反映することを除いて、RESOLVE_EXTERNAL_IDS​ は POLL_EXTERNAL_IDS​ と同義です。
BULK_LOAD_ERROR​ 一括ロードに失敗 このエラーは、マッピングの初期一括ロードまたはリロード中に問題があった場合に発生します。エラーの原因を調査してください。Heroku Connect ダッシュボード​の Logs​ (ログ) タブに移動し、Error​ ログ行をフィルタリングします。Heroku Connect でのほとんどの一括ロードは、Salesforce での一括バッチの失敗​によって引き起こされます。エラーの原因を特定して修正した後に、マッピングをリロード​します。
WAIT_BULK_UPDATE​ 一括ジョブの待機中 Connect は、Salesforce で一括ジョブが完了するのを待機中です。この状態は、APPLYING_BULK_UPDATE​ に先行します。データの初期ロードまたはリロードではなく、更新に関連する一括ジョブを反映することを除いて、WAIT_BULK_UPDATE​ は WAIT_BULK_LOAD​ と同義です。
APPLYING_BULK_UPDATE​ 更新中 [一括] Connect は、Salesforce の完了済みの一括バッチからデータを取得し、そのデータを Heroku Postgres で更新しています。データの初期ロードまたはリロードではなく、更新に関連する一括ジョブを反映することを除いて、APPLYING_BULK_UPDATE​ は LOADING_BULK_JOB​ と同義です。
POLL_EXTERNAL_IDS​ 外部 ID を解決中 Heroku Connect は、Postgres に設定する外部 ID を Salesforce に照会しています。マッピングに外部 ID 関係フィールドが含まれている場合、この操作は一括更新の適用後に実行されます。データの初期ロードまたはリロードではなく、更新に関連する一括ジョブを反映することを除いて、POLL_EXTERNAL_IDS​ は RESOLVE_EXTERNAL_IDS​ と同義です。
RECOVERY​ 再有効化中 ユーザーが接続を再認証した後、Heroku Connect で同期を回復しています。手動で回復をトリガー​することもできます。
ABORTED​ タスクが中止されました マッピングの最新の操作を手動で中止しました。詳細は、状態および中止されたマッピング操作​を参照してください。
SYSTEM_ERROR​ 予期しないエラー Heroku Connect で予期しないエラーが発生しました。Heroku Connect ダッシュボードで同期を再開​してください。原因になっている問題が解決しない場合は、接続のログ​を確認してください。問題を解決できない場合は、Heroku サポートにお問い合わせください。
DB_UNAVAILABLE​ DB 使用不可 Heroku Connect はデータベースに接続できません。データベースが応答し、Heroku Connect に接続されているアプリの環境設定として設定されていることを確認してください。Heroku Connect ダッシュボードで同期を再開​してください。
BAD_CONFIG​ 無効な設定 このオブジェクト用に保存された Salesforce 設定が、現在の Salesforce データモデルにマッピングされなくなりました。詳細は、BAD_CONFIG​を参照してください。
SYNC_REMOVED​ 削除中 マッピングを削除しました。
INACTIVE_ORG​ アクティブでない組織 (サンドボックス更新) Salesforce 組織がアクティブでないか、サンドボックスを更新しました。アクティブな組織または更新されたサンドボックスへの接続を再作成​してください。
UNAUTHORIZED​ SF 認証失敗 Salesforce への認証の期限が切れました。Salesforce データにアクセスするには、Heroku Connect を再認証​してください。

状態および中止されたマッピング操作

以下のいずれかの状態でマッピングを中止​すると、DATA_SYNCED​ 状態になります。通常の同期操作は、次のポーリングから再開されます。

  • POLLING_SF_CHANGES
  • POLLING_SF_BULK
  • POLLING_SF_FOR_DELETES
  • WAIT_BULK_UPDATE
  • APPLYING_BULK_UPDATE
  • POLL_EXTERNAL_IDS

以下のいずれかの状態でマッピングを中止​すると、ABORTED​ 状態のままになります。同期を再開するには、マッピングをリロードする​必要があります。

  • SCHEMA_CHANGED
  • RESYNC
  • WAIT_BULK_LOAD
  • LOADING_BULK_JOB
  • RESOLVE_EXTERNAL_IDS
  • RELOAD_TABLE