資料の 英語版 に戻る
DataStage での環境変数の管理
DataStageで環境変数を管理する
最終更新: 2025年3月12日
IBM® DataStage® の環境変数は、いくつかの異なる方法で管理できます。
DataStageでは、プロジェクトレベル、フローレベル、dsjobコマンドラインインターフェイス(CLI)の3つの異なる方法で環境変数を管理できます。
プロジェクト・レベル
プロジェクト・レベルから環境変数をセットアップするには、以下のステップを実行します。
- プロジェクトを開き、 「管理」 タブをクリックします。
- 「新規環境変数 +」 をクリックし、キーと値のペアを追加して編集します。 をクリックするか、既存のテンプレートを開いて
- 環境の詳細と構成を指定します。
- 「環境変数」 フィールドで、name=value のペアを使用してランタイム環境変数を指定します。次に例を示します。
CC_MSG_LEVEL=1 APT_CONFIG_FILE=/ds-storage/2nodes.apt
- 「作成」 をクリックします。
- DataStage フローから、ツールバーの 「設定」 アイコンをクリックし、 「設定」 ページの 「実行」 をクリックします。
- 作成した環境を選択し、 「保存」をクリックします。
DataStage フロー・レベル
フロー・レベルから環境変数を選択するには、以下のステップを実行します。
- DataStage フローを開きます。
- ツールバーの「パラメーターの追加」アイコン ({#}) をクリックします。
- 使用可能な環境変数のリストから 1 つ以上の環境変数を選択します。
- 「追加」をクリックし、 「キャンバスに戻る」をクリックします。
コマンドライン・インターフェース (CLI)
CLI から環境変数を渡すことができます。 次の例を参照してください。
cpdctl dsjob run --job "TestSimpleJavaWriteJSON.DataStage job" --project Project2021 --wait 300 --param FILE_NAME=/ds-storage/output/MySales5k.json --env "\$CC_MSG_LEVEL"="1"
詳しくは、 DataStage コマンド行ツールを参照してください。
オーバーライド・ルール
環境変数には、以下のオーバーライド・ルールが適用されます。
dsjob
CLI 環境変数は、 DataStage フロー・レベル環境変数を上書きします。- DataStage フロー・レベルの環境変数は、ランタイム環境レベルの環境変数を上書きします。
デフォルトで定義されている環境変数
以下のリストは、デフォルトで定義されている環境変数です。
- apt_old_bounded_length
- Cloud Pak for Data設定:APT_OLD_BOUNDED_LENGHT = true
- Cloud Pak for Dataの動作: PX が内部的に有界長の文字列と生のフィールドを処理する方法が、フィールドを可変長として扱うことから固定長に変更されました。 これは記録処理のパフォーマンスを向上させるために行われた。 古い可変長フォーマットのデータセットに書き込まれたものを読むにはtrueをセットする。
- 従来の (11.7) デフォルトの動作設定:APT_OLD_BOUNDED_LENGTH = false
- トラディショナル(11.7)設定での動作:古い可変長フォーマットで書かれたデータセットは読み込めません。
- apt_thread_safe_fast_alloc
- Cloud Pak for Dataの設定:APT_THREAD_SAFE_FAST_ALLOC = スレッドセーフ
- Cloud Pak for Data 動作: 値の文字列は、文字列のような一般的に使用されるオブジェクトを割り当てるために使用される高速アロケータのスレッド化モードを指定します。 高速アロケーターのインスタンスは、スレッド固有のストレージに保持される。
- 従来の (11.7) デフォルトの動作設定:APT_ THREAD_SAFE_FAST_ALLOC = レガシー (または) false
- トラディショナル (11.7) 設定での動作:Fast-allocator インスタンスはスレッド間で共有されます。
- apt_dont_allow_double_tsort_combine
- Cloud Pak for Dataの設定:APT_DONT_ALLOW_DOUBLE_TSORT_COMBINE = true
- Cloud Pak for Data 動作: デフォルトでは、結合演算子コントローラは、可能な限り多くのtsort演算子をマージします。 下流で結合演算子の後に結合ステージが続く場合、結合演算子が複数のtsort演算子を結合しないように、これはtrueに定義される。 これは、tsort-joinステージを含むハングリングシナリオを避けるために追加された。
- 伝統的な(11.7)デフォルトの動作設定:APT_DONT_ALLOW_DOUBLE_TSORT_COMBINE = false
- トラディショナル(11.7)設定での動作:複合演算子コントローラは、可能な限り多くのtsort演算子を組み合わせます。
- apt_scratch_reserve_mb
- Cloud Pak for Dataの設定:apt_scratch_reserve_mb = 10
- Cloud Pak for Dataの動作:ソートやバッファのような演算子はスクラッチディスクを使用する。 スクラッチ・ディスクに最低限の空き領域があれば、スクラッチ・ディスクはスクラッチ・ファイルの作成に使われる。 空き容量が最小MBに満たない場合は、最小空き容量基準を満たす次のスクラッチディスクが使用される。 APT_CONFIG_FILE に複数のスクラッチディスクが定義されている場合に適用される。
- 従来の (11.7) デフォルトの動作設定:APT_SCRATCH_RESERVE_MB = false
- Traditional (11.7) 設定での動作:2GB のデフォルトのスクラッチ予備領域が使用されます。
- apt_disable_jobmon_schema_string
- Cloud Pak for Data設定:APT_DISABLE_JOBMON_SCHEMA_STRING = trueです
- Cloud Pak for Data 動作:ジョブ・モニターへのlinkstatsメッセージでスキーマ情報を送信しないようにします。
- 従来の (11.7) デフォルトの動作設定:APT_DISABLE_JOBMON_SCHEMA_STRING = false
- トラディショナル(11.7)設定での動作: linkstatsでスキーマ情報を送信します。 現在、Cloud Pak for Data は linkstats からのスキーマ文字列を処理しません。 スキーマ情報は無効にできる。
- apt_ds_compression
- Cloud Pak for Data設定:APT_DS_COMPRESSION = true
- Cloud Pak for Dataの動作: この変数はデータセットの圧縮を有効にします。
- 伝統的な(11.7)デフォルトの動作設定:APT_DS_COMPRESSION = false
- トラディショナル(11.7)設定での動作:データセットは圧縮されていない。
- apt_import_force_quote_delim
- Cloud Pak for Data設定:APT_IMPORT_FORCE_QUOTE_DELIM = true
- Cloud Pak for Data 動作: デフォルトでは、引用符で囲まれたフィールドのインポートは、開閉引用符文字を探します。 フィールド・データに引用符が含まれている場合、この文字は引用符の終端であると誤認される。 この環境変数を設定すると、フィールドの区切り文字が続く閉じ引用符文字だけをインポートが認識するようになる。 この変更により、フィールドに埋め込まれた引用符文字が正しくインポートされるようになった。
- 従来の (11.7) デフォルトの動作設定:APT_IMPORT_FORCE_QUOTE_DELIM = false
- Traditional (11.7) 設定での動作: 引用文字が埋め込まれたフィールドのインポートではレコードがインポートされません。 デフォルトでは、警告が投げられ、レコードは拒否される。
- apt_tsort_scratch_compression
- Cloud Pak for Dataの設定:APT_TSORT_SCRATCH_COMPRESSION = true
- Cloud Pak for Data 動作: Tsortスクラッチファイルは、容量を節約する必要があるため、圧縮モードでディスクに書き込まれます。
- 従来の(11.7)デフォルトの動作設定:APT_TSORT_SCRATCH_COMPRESSION = false
- Traditional (11.7) 設定時の動作: Tsort スクラッチ ファイルは圧縮されずにディスクに書き込まれます。
- apt_downgraded_messages
- Cloud Pak for Dataの設定:APT_DOWNGRADED_MESSAGES = "JAVA_TOOL_OPTIONSのピックアップ:"
- Cloud Pak for Data 動作:Picked up JAVA_TOOL_OPTIONS: "という文字列を持つメッセージに対して、出力されるオーケストレーションのエラーまたは警告メッセージの重大度をInformationalに変換します。
- 従来の (11.7) デフォルトの動作設定:APT_DOWNGRADED_MESSAGES = false
- Traditional (11.7) 設定での動作: メッセージはダウングレードされません。 しかし、ユーザーは新しい値で上書きすることができる。 この変数の書式は、タイムスタンプ部分を除いた、重大度を通知する必要があるエラーメッセージや警告メッセージの全部または一部のリストである。 各メッセージは#?#というユニークな文字列で区切られている。
- 例:APT_DOWNGRADED_MESSAGES = READ is not supported in state standby#?#IPv6 is not currently supported.
- apt_impexp_infer_eol_record_delim
- Cloud Pak for Data設定:APT_IMPEXP_INFER_EOL_RECORD_DELIM = true
- Cloud Pak for Data 動作: シーケンシャル ファイル インポート レイヤーは、Unix EOL レコード区切り記号が設定されているときに Windows EOL レコード区切り記号を探し、ファイルが正しくインポートされるようにします。
- 従来の (11.7) デフォルトの動作設定:APT_IMPEXP_INFER_EOL_RECORD_DELIM = false
- Traditional (11.7) 設定での動作: シーケンシャル ファイル インポート レイヤは、インポート プロパティで設定された EOL レコード区切り文字のみを検索します。
トピックは役に立ちましたか?
0/1000