tRunJob標準プロパティ - 7.3

Orchestration (Integration)

Version
7.3
Language
日本語 (日本)
Product
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Open Studio for Big Data
Talend Open Studio for Data Integration
Talend Open Studio for ESB
Talend Real-Time Big Data Platform
Module
Talend Studio
Content
ジョブデザインと開発 > サードパーティーシステム > プロセス制御コンポーネント
データガバナンス > サードパーティーシステム > プロセス制御コンポーネント
データクオリティとプレパレーション > サードパーティーシステム > プロセス制御コンポーネント

このプロパティはStandardジョブフレームワークで実行されているtRunJobを設定するために使います。

標準tRunJobコンポーネントはシステムファミリーとプロセス制御ファミリーに属しています。

このフレームワーク内のコンポーネントは、すべてのTalend製品で使用できます。

警告:

tRunJobコンポーネントは制限付きでサポートされています。すなわち、S4 (マイナー)サポートケースのみ受け入れられ、パッチの提供はありません。データサービスとルート(cTalendJobを使用)内でtRunJobを使用する場合、サポートは"ベストエフォート"ベーシスでのみ提供されます。ほとんどの場合、クラスローディングの問題があり、これは解決できる場合もありますが、いつも解決できるわけではありません。

これは、tRunJobがサービス/ルートスタイル(ESB)のデプロイで機能するように設計されていないためです。そのため、これを使用する場合は、うまくいくケースも多くあるものの、正規のサポートを受けることができません。過去にtRunJobを使用した方には、ジョブデザインにジョブレットを使用するよう切り替えることをお勧めします。

DIと非ESBのユースケースでは依然として有用なコンポーネントであり、サポートを受けることができます。

基本設定

[Schema] (スキーマ)および[Edit Schema] (スキーマを編集) (スキーマを編集)

スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。

スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを使用できます。

  • [View schema] (スキーマの表示): スキーマのみを表示する場合は、このオプションを選択します。

  • [Change to built-in property] (組み込みのプロパティに変更): ローカルで変更を行うためにスキーマを組み込みに変更する場合は、このオプションを選択します。

  • [Update repository connection] (リポジトリー接続を更新): リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。変更を現在のジョブにのみ反映する場合は、変更後、[No] (いいえ)を選択し、[Repository Content] (リポジトリーのコンテンツ)ウィンドウで再びこのスキーマのメタデータを選択します。

このコンポーネントはダイナミックスキーマ機能の利点を備えているので、ソースファイルから不明なカラムを取得したり、各カラムを個別にマッピングしなくてもソースからカラムを一括してコピーしたりできます。ダイナミックスキーマの詳細は、『 Talend Studio ユーザーガイド』を参照してください。

このダイナミックスキーマ機能は、テーブルの不明なカラムを取得する目的で設計されており、この目的に限り使用をお勧めします。テーブルの作成で使用することは勧められていません。

 

[Built-in] (組み込み): そのコンポーネントのみのスキーマを作成して、ローカルに保存します。

 

[Repository] (リポジトリー): スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。

[Copy Child Job Schema] (子ジョブスキーマのコピー)

クリックして子ジョブスキーマを取得します。

[Use dynamic job] (ダイナミックジョブの使用)

複数のジョブを呼び出して処理できるようにするには、このチェックボックスをオンにします。このオプションを有効にした場合、最新バージョンのジョブのみが呼び出され、処理されます。サブジョブの実行には、独立したプロセスが使われます。2つのオプション、[Context] (コンテキスト)および[Use an independent process to run subJob] (サブジョブを独立したプロセスで実行)が表示されなくなります。

警告:
  • [Use dynamic job] (ダイナミックジョブの使用)オプションは、ジョブサーバーのキャッシュに対応していません。したがって、Talend Administration CenterでこのチェックボックスがオンになったtRunjobを含むジョブを実行すると、失敗する可能性があります。
  • このオプションは、データベース接続コンポーネントの[Use or register a shared DB Connection] (共有DB接続の使用または登録)と互換性がありません。tRunJobをデータベース接続コンポーネントと共に使用する場合、両方のオプションが有効になっていると、ジョブが失敗します。
  • このオプションはESBルートやデータサービスではサポートされていません。

[Context job] (コンテキストジョブ)

このフィールドは、 [Use dynamic job] (ダイナミックジョブの使用)オプションを選択している場合にのみ表示されます。選択したジョブのリストから呼び出すジョブの名前を入力します。

[Job] (ジョブ)

呼び出して処理するジョブを選択します。tRunJobによるスムーズな実行を確保するには、ジョブを呼び出したら、前もって、実行済みであることを確認します。

[Version] (バージョン)

使用する子ジョブバージョンを選択します。

[Context] (コンテキスト)

このコンポーネントによって呼び出すジョブのコンテキストと変数を定義したら、リストから該当するコンテキストエントリを選択します。

[Use an independent process to run subJob] (サブジョブを独立したプロセスで実行)

サブジョブを独立したプロセスで実行するには、このチェックボックスをオンにします。これは、メモリ制限に起因する問題の解決に役立ちます。

警告:
  • このオプションはJobserverキャッシュと互換性がありません。したがって、Talend Administration CenterでこのチェックボックスがオンになったtRunJobを含むジョブを実行すると、失敗する可能性があります。
  • このオプションは、データベース接続コンポーネントの[Use or register a shared DB Connection] (共有DB接続の使用または登録)と互換性がありません。tRunJobをデータベース接続コンポーネントと共に使用する場合、両方のオプションが有効になっていると、ジョブが失敗します。
注: このオプションを選択した場合、子ジョブログは利用できません。

[Die on child error] (子のエラー発生時に強制終了)

子ジョブの実行時にエラーが発生した時でも親ジョブを実行する場合には、このチェックボックスをオフにします。

[Transmit whole context] (コンテキスト全体の転送)

すべてのコンテキスト変数を親ジョブから取得するには、このチェックボックスをオンにします。このチェックボックスをオフに設定すると、すべてのコンテキスト変数が子ジョブから取得されます。

親ジョブと子ジョブに同じコンテキスト変数が定義されている時に、このチェックボックスをオンにすると:
  • [Context Param] (コンテキストパラメーター)テーブルで関連値が定義されていなければ、子ジョブの実行中、親ジョブの変数値が使用されます。

  • それ以外の場合は、[Context Param] (コンテキストパラメーター)テーブルで定義された値が子ジョブの実行中に使用されます。

[Context Param] (コンテキストパラメーター)

選択されているコンテキストパラメーターの値は変更できます。[+]ボタンをクリックし、子ジョブの[Context] (コンテキスト)タブで定義したパラメーターを追加します。コンテキストパラメーターについては、 Talend Studioユーザーガイドを参照してください。

ここで定義した値は、[Transmit whole context] (コンテキスト全体の転送)を選択している場合でも、子ジョブの実行中に使用されます。

詳細設定

[Propagate the child result to the output schema] (子ジョブの結果を出力スキーマにプロパゲート) このチェックボックスをオンにすると、子ジョブにおいてtBufferOutputコンポーネント経由でバッファーメモリに格納された出力データが、親ジョブの出力コンポーネントにプロパゲートされます。

このプロパティは、tFixedFlowInputなどの入力コンポーネントからのデータがある場合にのみ有効です。

このチェックボックスは、デフォルトでオフになっています。[Use dynamic job] (ダイナミックジョブの使用)または[Use an independent process to run subJob] (サブジョブを独立したプロセスで実行)チェックボックスがオンの場合は表示されません。

[Print Parameters] (印刷パラメーター) 内部および外部パラメーターを[Console] (コンソール)に表示するには、このチェックボックスをオンにします。

[JVM Setting] (JVM設定)

呼び出しまたは処理が行われるジョブのJVM設定を指定します。

  • [Use child job JVM arguments] (子ジョブのJVM引数を使う): 子ジョブのJVM引数を使うには、このオプションを選択します。
  • [Overwrite child job JVM arguments] (子ジョブのJVM引数を上書きする): カスタマイズされたJVM引数を使うには、このオプションを選択します。カスタマイズされた引数を追加するには、JVMフレームの下にある[+]ボタンをクリックし、フレームに追加された新しい行を編集します。

[Use dynamic context for subJob] (サブジョブ用にダイナミックコンテキストを使用)

このオプションを選択して、呼び出されるサブジョブのコンテキスト変数グループを指定します。このオプションを選択した後に、右側のテキストフィールドに変数名を入力します。変数の値は、既存のコンテキスト変数グループの名前である必要があります。

注:
  • このオプションは、[Basic settings] (基本設定)ビューで[Context] (コンテキスト)オプションが優先されます。
  • このオプションは、TalendのR2021-07以降のStudio月次アップデートをインストールした時のみ利用できます。詳細は管理者にお問い合わせください。

[Use extra classpath for subJob] (サブジョブ用に追加クラスパスを使用)

このオプションを選択して、呼び出されるサブジョブの追加クラスパスを指定します。このオプションを選択した後に、右側のテキストフィールド内に1つ以上のクラスパスを追加します。複数のパスを追加する場合は、; (Windows版)または: (Linux版)を使ってパスを区切ります。

注:
  • このオプションは、[Basic settings] (基本設定)ビューで[Use dynamic job] (ダイナミックジョブを使用)または[Use an independent process to run subjob] (独立したプロセスで実行)が選択されている場合に使用できます。
  • このオプションは、TalendのR2021-07以降のStudio月次アップデートをインストールした時のみ利用できます。詳細は管理者にお問い合わせください。
[tStatCatcher Statistics] (tStatCatcher統計) このチェックボックスをオンにすると、ジョブレベルおよび各コンポーネントレベルで処理メタデータが収集されます。

グローバル変数

[Global Variables] (グローバル変数)

ERROR_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、Die on error (エラー時強制終了)がオフになっている場合にのみ機能します。

CHILD_RETURN_CODE: 子ジョブの戻りコード。これはAfter変数で、整数を返します。

CHILD_EXCEPTION_STACKTRACE: 子ジョブからの例外スタックトレース。これはAfter変数で、文字列を返します。

Flow変数はコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。

フィールドまたは式に変数を入れるには、Ctrl + Spaceを押して変数リストにアクセスし、リストから使用する変数を選択します。

変数の詳細は、『 Talend Studio ユーザーガイド』を参照してください。

使用方法

使用ルール このコンポーネントはスタンドアロンジョブとして使えます。または、1つのジョブ内のサブジョブが多くなりすぎないようにすることで、複雑なジョブをわかりやすくするのに役立ちます。

コンポーネントの再利用可能なグループを作成して複数のジョブに挿入したり、同じジョブ内に数回作成したりする場合は、ジョブレットを使用するという方法があります。tRunJobとは異なり、ジョブレットは、それが挿入されているジョブのコンテキスト変数を使用します。ジョブレットの詳細は、 Talend Studioユーザーガイドを参照してください。

このコンポーネントは、Spark BatchジョブまたはSpark Streamingジョブなど、異なるフレームワークのジョブを呼び出すこともできます。

 [Connections] (接続) 外部リンク(このコンポーネントから別のコンポーネントへのリンク):

[Row] (行): メイン。

[Trigger] (トリガー): [On Subjob Ok] (サブジョブがOKの場合)、[On Subjob Error] (サブジョブがエラーの場合)、[Run if] (条件付き実行)、[On Component Ok] ( コンポーネントがOKの場合)、[On Component Error] (コンポーネントがエラーの場合)

受信リンク (あるコンポーネントからこのコンポーネントへのリンク):

[Row] (行): メイン、拒否、反復する

[Trigger] (トリガー): On Subjob Ok; On Subjob Error; Run if; On Component Ok; On Component Error; Synchronize; Parallelize

接続に関する詳細は、『 Talend Studioユーザーガイド』を参照してください。