Error handling
Basic
Apply conflicts
Duplicate key when applying INSERT: Select what action to take when there is a conflict with an INSERT operation.
-
Ignore: The task continues and the error is ignored.
-
UPDATE the existing target record: The target record with the same primary key as the INSERTED source record is updated.
- Log record to the exceptions table (default): The task continues and the error is written to the exceptions table.
-
Suspend table: The task continues but data from the table with the error record is moved into an error state and its data is not replicated.
- Stop task: The task is stopped and manual intervention is required.
No record found for applying an UPDATE: Select what action to take when there is a conflict with an UPDATE operation.
- Ignore: The task continues and the error is ignored.
-
INSERT the missing target record: The missing target record will be inserted into the target table. When the source endpoint is Oracle, selecting this option requires supplemental logging to be enabled for all the source table columns.
- Log record to the exceptions table (default): The task continues and the error is written to the exceptions table.
-
Suspend table: The task continues but data from the table with the error record is moved into an error state and its data is not replicated.
- Stop task: The task is stopped and manual intervention is required.
Advanced
Data errors
Data truncation errors
データ切り捨てエラーの場合: 1 つ以上の特定のレコードで切り捨てが発生した場合に実行する処理を選択します。リストから次のいずれかを選択できます。
- 無視: タスクは続行され、エラーは無視されます。
- 例外テーブルへのログ レコード (既定): タスクは続行され、エラーは例外テーブルに書き込まれます。
- テーブルを一時停止: タスクは続行されますが、エラー レコードのあるテーブルのデータはエラー状態に移行し、そのデータはレプリケートされません
- タスクを停止: タスクは停止され、手動による操作が必要となります。
Data truncation error handling is supported in Apply Changes replication mode only (not Full Load).
Other data errors
その他のデータ エラーの場合: 1 つ以上の特定のレコードでエラーが発生した場合に実行する処理を選択します。リストから次のいずれかを選択できます。
- 無視: タスクは続行され、エラーは無視されます。
- 例外テーブルへのログ レコード (既定): タスクは続行され、エラーは例外テーブルに書き込まれます。
- テーブルを一時停止: タスクは続行されますが、エラー レコードのあるテーブルのデータはエラー状態に移行し、そのデータはレプリケートされません
- タスクを停止: タスクは停止され、手動による操作が必要となります。
Escalating data error handling
その他のデータ エラーが発生した場合にエラー処理をエスカレートします (テーブルごと): このチェック ボックスをオンにすると、非切り捨てデータ エラーの数 (テーブルごと) が指定された量に達したときにエラー処理がエスカレートされます。有効な値は 1 ~ 10,000 です。
エスカレーション アクション: エラー処理がエスカレートされたときに実行される処理を選択します。使用できるアクションは、上記の [その他のデータ エラーの場合] ドロップダウン リストから選択したアクションに応じて異なります。
-
テーブルを一時停止 (既定): タスクは続行されますが、エラー レコードのあるテーブルのデータはエラー状態に移行し、そのデータは 移動済み されません。
情報メモ動作は変更処理モードに応じて異なります。
-
トランザクションの適用モードでは、最後の変更は 移動済み されません。
-
バッチ最適化の適用モードでは、データがまったく 移動済み されない、または部分的にのみ 移動済み される状況が発生する可能性があります。
-
- タスクを停止: タスクは停止され、手動による操作が必要となります。
- 例外テーブルにレコードを記録: タスクは続行され、レコードは例外テーブルに書き込まれます。
Table errors
テーブル エラーを返す前の再試行回数
このオプションを使用すると、テーブル エラー処理ポリシーがトリガーされるタイミングを制御できます。既定では、テーブル エラーが発生すると、3 回の再試行後にテーブルが一時停止されるか、タスクが停止されます (選択したアクションに応じて)。SaaS アプリケーションの計画メンテナンスにより、テーブル エラーが発生する場合があります。このような場合、テーブル エラー処理ポリシーがトリガーされる前にメンテナンスを完了するには、既定の再試行回数では不十分な可能性があります。タスクが実行されるたびに再試行が実行されるため、これはタスクのスケジュール間隔にも依存します。たとえば、タスクを 1 時間ごとに実行するようにスケジュールし、タスクの実行開始と同時に SaaS アプリケーションがメンテナンスのためにオフラインになった場合、既定の 3 回の再試行により、テーブル エラー処理ポリシーがトリガーされることなく、SaaS アプリケーションを最大 3 時間オフラインにすることができます。メンテナンス期間が長くなると、テーブル エラー処理ポリシーがトリガーされないように、再試行回数を増やす (またはスケジュールを変更する) 必要があります。
まとめると、SaaS アプリケーションが定期的にメンテナンスされることがわかっている場合、テーブル エラー処理ポリシーがトリガーされることなくメンテナンスを完了できるように、スケジュールに従って再試行回数を増やすことがベスト プラクティスとなります。
-
このオプションは、Lite または Standard SaaS アプリケーション コネクタで構成されたタスクにのみ表示されます。
-
Data Movement gateway を使用している場合は、バージョン 2024.11.70 以降が必要です。
テーブル エラーが発生した場合: ドロップダウン リストから次のいずれかを選択します。
- テーブルを一時停止 (既定): タスクは続行されますが、エラー レコードのあるテーブルのデータはエラー状態に移行し、そのデータはレプリケートされません。
- タスクを停止: タスクは停止され、手動による操作が必要となります。
テーブル エラーが次の値に達した場合に処理をエスカレート (テーブルごと): このチェック ボックスをオンにすると、テーブル エラーの数 (テーブルごと) が指定された量に達した場合にエラー処理をエスカレートします。有効な値は 1 ~ 10,000 です。
エスカレーション アクション: テーブル エラーのエスカレーション ポリシーは [タスクを停止] に設定されており、変更できません。
Apply conflicts
No record found for applying a DELETE: Select what action is taken when there is a conflict with a DELETE operation.
- Ignore: The task continues and the error is ignored.
- Log record to the exceptions table: The task continues and the record is written to the exceptions table.
- Suspend table: The task continues but data from the table with the error record is moved into an error state and its data is not replicated.
- Stop task: The task is stopped and manual intervention is required.
Escalating Apply conflicts error handling
Escalate error handling when apply conflicts reach (per table): Select this check box to escalate error handling when the number of apply conflicts (per table) reaches the specified amount. Valid values are 1-10,000.
Escalation action: Choose what should happen when error handling is escalated:
- Log record to the exceptions table (default): The task continues and the error is written to the exceptions table.
-
Suspend table: The task continues, but data from the table with the error record is moved into an error state and its data is not replicated.
情報メモThe behavior differs according to the Change Processing Mode:
-
In Transactional apply mode, the last changes will not be replicated
-
In Batch optimized apply mode, a situation is possible where there will be no replication of data or data replication will be partial.
-
-
Stop task: The task is stopped and manual intervention is required.
Environmental errors
-
最大再試行数: このオプションを選択すると、復元可能な環境エラーが発生した場合にタスクを再試行する最大回数を指定できます。タスクが指定された回数再試行されると、タスクは停止され、手動による操作が必要となります。
タスクを再試行しない場合は、チェック ボックスをオフにするか、「0」を指定します。
タスクを無限に再試行するには、「-1」を指定します。
-
再試行の間隔 (秒): カウンターを使用して、システムがタスクを再試行するまでに待機する秒数を選択または入力します。
有効な値は 0 ~ 2,000 です。
-
- 長時間の停止の場合は再試行間隔を長くする: 長時間停止した場合の再試行間隔を長くするには、このチェック ボックスをオンにします。このオプションを有効にすると、最大再試行間隔に達するまで、各再試行と次の再試行の間隔が 2 倍になります (指定された最大間隔に従って再試行を継続します)。
- 最大再試行間隔 (秒): [長時間の停止の場合は再試行間隔を長くする] オプションが有効になっている場合、カウンターを使用して、タスクの再試行間隔を待機する秒数を選択または入力します。有効な値は 0 ~ 2,000 です。