DataStage のチェックポイント環境変数

最終更新: 2025年3月12日

以下の環境変数を使用して、 DataStage®を自動的に再始動するためのチェックポイントを設定できます。

チェックポイントおよびその他の環境変数のセットアップについて詳しくは、 DataStageでのチェックポイントおよび再始動機能の探索を参照してください。

DataStage の APT_CHECKPOINT_BLOCK_SIZE 環境変数

APT_CHECKPOINT_BLOCK_SIZE 環境変数を設定して、チェックポイント・データが分割されるファイルのサイズを指定します。

デフォルト値は 64MBです。

DataStage の APT_CHECKPOINT_ENABLED 環境変数

APT_CHECKPOINT_ENABLED 環境変数を設定して、変数の値に応じて、ソート後およびターゲット演算子の前にチェックポイントがスコアに挿入されるようにします。

いずれかのターゲットがファイナライズされる前のチェックポイントが完了し、ジョブが失敗した場合、ジョブは自動的に再始動されません。ソートがファイナライズされる前、またはジョブが失敗する前にチェックポイントが挿入された場合、それらのチェックポイントは失敗時の開始点として使用され、ジョブを再始動します。この環境変数には、以下の値を指定できます。

ターゲットのみ: ターゲット・オペレーターのみの前にチェックポイントを挿入します。
ソートのみ: ソート・ステージのみの前にチェックポイントを挿入します。
クリーン: ジョブが開始される前に、APT_CHECKPOINT_PERSISTENT パスに指定されているすべてのチェックポイント・ファイルを削除します。
その他の値: 環境変数が定義されていて、他のストリングと等しい場合は、両方のチェックポイント・タイプが挿入されます。

DataStage の APT_CHECKPOINT_NO_COMPRESSION 環境変数

APT_CHECKPOINT_NO_COMPRESSION 環境変数を設定して、チェックポイントの作成時に生成されたファイルが、失敗後に DataStage を自動的に再始動するように圧縮されるようにします。チェックポイント・ファイルは、デフォルトで圧縮されます。この変数が任意の値に定義されている場合、圧縮はオフになります。

DataStage の APT_CHECKPOINT_PERSISTENT 環境変数

APT_CHECKPOINT_PERSISTENT 環境変数を設定して、失敗したジョブ実行間でチェックポイントを保持します。

実行されるさまざまなジョブに対してチェックポイントを保持できるようにするかどうかを指定します。チェックポイントが有効になっているジョブが失敗した場合、完了している既存のチェックポイント・ファイルがあれば、そのジョブを手動で再始動することができます。ジョブは、最初から開始するのではなく、チェックポイントから開始します。ジョブが失敗し、自動的に再始動できない場合にチェックポイント・データを保存するには、ファイル名へのパスを指定してこの変数を定義します。この変数を同じファイルに設定してジョブを手動で再実行し、完了したチェックポイントから開始することができます。