マッピング状態のリファレンス
最終更新日 2022年12月13日(火)
Table of Contents
マッピング状態とは、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