0 / 0

DataStageのデバッグ環境変数

最終更新: 2025年3月12日
DataStage での環境変数のデバッグ

これらの環境変数は、 DataStage® パラレル・ジョブのデバッグに関係しています。

DataStage の APT_DEBUG_MODULE_NAMES 環境変数

APT_DEBUG_MODULE_NAMES 環境変数は、デバッグするモジュールのモジュール名のリストを指定します。

モジュール名のリストは空白文字で区切られます。 リスト内のモジュール名ごとに、モジュール内の内部 IF_DEBUG ステートメントが実行されます。 subproc オペレーター・モジュール (モジュール名は「subproc」) は、この機能を使用するモジュールの 1 つの例です。

DataStage の APT_DEBUG_SUBPROC 環境変数

各サブプロセス・オペレーターに関するデバッグ情報を表示します。

DataStage の APT_EXECUTION_MODE 環境変数

アプリケーションを順次実行モードで実行するように APT_EXECUTION_MODE 環境変数を設定します。

デフォルトでは、実行モードは並列であり、複数のプロセスがあります。 アプリケーションを順次実行モードで実行するには、APT_EXECUTION_MODE を以下のいずれかの値に設定します。

  • ONE_PROCESS ワン・プロセス・モード
  • MANY_PROCESS 多処理モード
  • NO_SERIALIZE 多処理モード (シリアライゼーションなし)

ONE_PROCESS モードの場合:

  • アプリケーションは、単一の UNIX プロセスで実行されます。 実行する必要があるデバッガー・セッションは 1 つだけで、コード内のどこにでもブレークポイントを設定できます。
  • データは、構成ファイルで定義されているノードの数に従ってパーティション化されます。
  • 各オペレーターはサブルーチンとして実行され、そのオペレーターが操作しなければならない区画の数に適した回数と呼ばれます。

MANY_PROCESS モードでは、フレームワークは各オペレーターのインスタンスごとに新しいプロセスを fork し、サブルーチンとしてオペレーターを呼び出すのではなく、完了するまで待機します。

どちらの場合も、ステップは構成全体に分散されるのではなく、コンダクター・ノード全体で実行されます。

NO_SERIALIZE モードは MANY_PROCESS モードと似ていますが、オブジェクトのロードおよび保存に DataStage パーシスタンス・メカニズムは使用されません。 派生 C++ クラスでのエラーの追跡には、パーシスタンスをオフにすると便利な場合があります。

DataStage の APT_NO_PM_SIGNAL_HANDLER 環境変数

APT_NO_PM_SIGNAL_HANDLER 環境変数を設定して、UNIX 上でデバッグに使用するコアを生成します。

DataStage の APT_PM_SHOW_PIDS 環境変数

APT_PM_SHOW_PIDS 環境変数が設定されている場合、プレイヤーは始動時にプロセス ID を表示する通知メッセージを出力します。

DataStage の APT_SHOW_LIBLOAD 環境変数

APT_SHOW_LIBLOAD 環境変数が設定されている場合、ライブラリーがロードされるたびに、メッセージが stdout ファイルに書き込まれます。

これらのメッセージは、正しいライブラリーがロードされていることを確認するのに役立ちます。
注: メッセージは、エラー・ログではなく stdout に出力されます。

DataStageのAPT_CATCH_SIGSEGV環境変数

APT_CATCH_SIGSEGV は、catchsegv ツールによるジョブの実行を可能にする。 デフォルト値はFalseである。 この変数はブール型である。

DataStageのAPT_DEBUG_METRICS_MESSAGES環境変数

APT_DEBUG_METRICS_MESSAGESを使用すると、ジョブ・メトリクス・メッセージをジョブ・ログに記録できます。 デフォルト値はFalseである。 この変数はブール型である。

DataStageのAPT_DEBUG_S3環境変数

APT_DEBUG_S3が定義されている場合、S3への書き込みと読み込みに関連するメッセージを表示する。 デフォルト値はFalseである。 この変数はブール型である。

DataStageのAPT_DEBUG_TSORT_SCRATCH_SIZE環境変数

APT_DEBUG_TSORT_SCRATCH_SIZE が定義されている場合、圧縮前と圧縮後のスクラッチファイルのサイズを表示し、圧縮を有効にすることでどの程度効果があったかを把握します。 デフォルト値はFalseである。 この変数はブール型である。

DataStageの環境変数APT_ELT_PUSHDOWN_LOG_LEVEL

APT_ELT_PUSHDOWN_LOG_LEVELは、ELTプッシュダウンジョブに対してdbtからの追加デバッグログを有効にします。 この変数はリスト型である。

DataStageのAPT_PM_DUMP_SCHEMAS環境変数

APT_PM_DUMP_SCHEMASが設定されている場合、Parallelジョブはジョブ内の各データセットのスキーマを示すレポートを作成します。 デフォルト値はFalseである。 この変数はブール型である。