トランザクションの中止

Pythonトランスフォームは、出力データセットが変更されない場合（新しいデータがデータセットに書き込まれない場合）にジョブを正常に完了させるためのトランザクションの中止をサポートしています。これは、トランスフォーム デコレータを使用し、TransformOutput オブジェクト上で .abort() を呼び出すことにより実現されます。

トランザクションの中止は、特定の条件下で出力データセットと下流のデータセットの更新を防ぐ必要がある場合に使用できます。出力データセットが更新されるとすぐに、下流のデータセットは古いものとみなされ（stale）、次にビルドされるとき（手動またはスケジュールされたビルドによる）に更新されます。ビルドの失敗に対する代替手段を提供します。これにより、何が実際に失敗しているかを特定しやすくなります。

中止されたトランザクションは、データセットのトランザクション履歴でグレー表示され、成功したジョブとして表示されます。これにより、成功したビルドがコミットされたトランザクションを結果としたかどうかを一目で区別できます。

トランザクションを中止する場合の例：

• 入力データセットの内容に基づいてデータセットを更新するためのカスタム条件がある場合。
• データセットが古くならないため、強制的にビルドする必要がある場合。これには、入力データセットの代わりにAPI呼び出しからデータを取得するデータセットが含まれます。
• スケジュールされたときに常に更新される書き戻しデータセットがある場合（詳細な例については以下を参照）。

例：仮想のカスタム条件

以下に、入力データセットに今日のデータが到着した場合にのみデータセットを更新したいと考える可能性がある、単純な仮想例を示します。

中止されたトランザクションと無視されたジョブはどう違いますか？

ジョブが「無視」されると、ジョブスペックが古くないとFoundryが判断したため、計算は実行されません。トランザクションが中止されると、ジョブは実行され、成功裏に完了しますが、出力データセットは変更されず、トランザクションはコミットされません。

中止されたトランザクションは増分トランザクションとどのように関連していますか？

増分トランスフォームは、入力と出力の両方のデータセットビューをコミットされたトランザクションだけを使用して読み取ります。これは、増分計算を行うときに中止されたトランザクションを無視することを意味します。

増分トランスフォームのすべての出力でトランザクションが明示的に中止されると、次のビルドは中止されたトランザクションが一度も発生していないかのように入力を読み取り（したがって再処理）、増分的に実行できるようになります。トランザクションが出力の一部だけで中止されると、ビルドは増分的に実行できなくなります。中止されたトランザクションがある出力の場合、出力ジョブスペックは中止されたトランザクションが無視されるため、以前の入力トランザクション範囲を使用します。コミットされたトランザクションがある出力の場合、出力ジョブスペックは現在の入力トランザクション範囲を使用します。この入力トランザクション範囲の不一致により、トランスフォームは増分的に実行できなくなります。