RunAJobユーティリティの使用
RunAJobユーティリティを使用するには、RunAJobユーティリティコマンドを引数とともに入力します。
次の文字列がRunAJobユーティリティコマンドです。
cli.bat runAJobCli
ジョブごとに、実行するタスクまたはタスクフローを指定する必要があります。データ統合タスクフローを実行するために使用する構文は、タスクを実行するために使用する構文とわずかに異なります。
実行中のタスク
次のコマンドは、名前と場所でタスクを指定してタスクを実行するための構文の例です。
cli.bat runAJobCli -t <tasktype> -n <task name> -fp <folder path to the task>
例えば、データ取り込みおよびレプリケーションファイル取り込みとレプリケーションタスクでは、次のコマンドを使用できます。
cli.bat runAJobCli -t MI_TASK -n mitask_Arch_2308 -fp myproject/folder1
次のコマンドは、フェデレーションタスクIDでタスクを指定してジョブを実行するための構文の例です。
cli.bat runAJobCli -t <tasktype> -fi <federated task ID>
例えば、フェデレーションタスクIDを使用してデータ統合の同期タスクを実行するには、次のようなコマンドを使用できます。
cli.bat runAJobCli -t DSS -fi kvOF40yLXyUihm7wYYskmh
データ統合タスクフローの実行
RunAJobユーティリティユーティリティを使用してタスクフローを実行するには、タスクフローがパブリッシュされる必要があります。また、Taskflow Designerの［許可されたユーザー］および［許可されたグループ］に値を含める必要があります。詳細については、データ統合ヘルプの「タスクフロー」を参照してください。
各ジョブに対し、タスクフローの名前を使用して実行するタスクフローを指定する必要があります。
タスクフローを実行するには、次の構文を使用します。
cli.bat runAJobCli -t TASKFLOW -un <taskflow name>
例えば、次のコマンドを使用できます。
cli.bat runAJobCli -t TASKFLOW -un myPublishedTaskflow
パラメータセットを使用したデータ統合タスクフローの実行
パラメータセットを使用して、タスクフロー入力パラメータの値を指定し、RunAJobユーティリティを使用してタスクフローを実行できます。
RunAJobユーティリティを使用してパラメータセットでタスクフローを実行する方法の詳細については、
https://knowledge.informatica.com/s/article/DOC-19232を参照してください。この記事には、ユーティリティをダウンロードするためのリンクも含まれています。
パラメータセットを使用するタスクフローを実行する場合は、RunAJobユーティリティコマンドの後に-punまたは--parameterSetUniqueName引数を指定して入力します。
RunAJobユーティリティを使用してタスクフローを実行するには、タスクフローがパブリッシュされる必要があります。また、［Taskflow Designer］の［許可されたユーザー］および［許可されたグループ］に値を含める必要があります。詳細については、データ統合ヘルプの「タスクフロー」を参照してください。
パラメータセットを使用するタスクフローを実行するには、次の構文のいずれかを使用します。
cli.bat runAJobCli -t TASKFLOW -un <taskflow_name> -fp <folder_path> -pun <unique_param_set_name>
cli.bat runAJobCli -t TASKFLOW -un <taskflow_name> -fp <folder_path> --parameterSetUniqueName <unique_param_set_name>
以下に例を示します。
cli.bat runAJobCli -t TASKFLOW -un myTaskflow -fp myproject/folder1 -pun sampleParamSet
cli.bat runAJobCli -t TASKFLOW -un myTaskflow -fp myproject/folder1 --parameterSetUniqueName sampleParamSet
すべてのタスクフローは、RunAJobユーティリティから/tfエンドポイントを使用して実行されます。
注: Linuxでユーティリティを使用し、別のスクリプトまたはラッパースクリプトを使用してcli.shを呼び出す場合、cli.shファイルの次の行にコメントが必要です。
cd "$SCRIPT_DIR"
この行にコメントを入れないと、次のエラーを受信する可能性があります。
Could not find or load main class com.informatica.saas.utilities.plugins.RunAJobPlugin.
タスクの場所
コマンドにフォルダパスかフェデレーションタスクIDを含めない場合、Defaultフォルダのタスクが実行されます。
タスクがDefaultフォルダにない場合や、同じ名前のタスクが複数のフォルダにある場合は、コマンドにフォルダパスかフェデレーションタスクIDを含めてください。
フェデレーションタスクIDを取得するには、REST APIバージョン3のlookupリソースを使用してPOST要求を送信します。
RunAJobユーティリティの引数
RunAJobユーティリティは、引数の短いオプションと長いオプションをサポートします。短い引数の前には1つのハイフンを付けます。長い引数の前には2つのハイフンを付けます。
RunAJobコマンドでは次の引数を使用できます。
パラメータ | 短い引数 | 長い引数 | 説明 |
|---|
username | -u | --user | Informatica Intelligent Cloud Servicesのユーザー名。 |
password | -p | --password | Informatica Intelligent Cloud Servicesのパスワード。 |
baseUrl | -bu | --baseUrl | ベースURL。デフォルトはhttps://dm-us.informaticacloud.com/maです。 必須。 |
taskId | -i | --taskId | タスクID。 コマンドにタスク名かフェデレーションタスクIDが含まれていない場合は必須。 タスクフローには適用されません。 |
folderPath | -fp | --folderPath | タスクの場所へのフォルダパス（myproject/folder1など）。 タスクがDefaultフォルダになく、コマンドにフェデレーションタスクIDが含まれていない場合は必須。 タスクフローには適用されません。 |
frsId | -fi | --frsId | グローバル一意識別子であるフェデレーションタスクID。 タスクがDefaultフォルダになく、コマンドにフォルダパスが含まれていない場合は必須。 タスクフローには適用されません。 |
taskflowUniqueName | -un | --taskflowUniqueName | タスクフローの一意の名前。 データ統合タスクフローの場合は必須。taskNameの代わりに使用してください。 |
taskName | -n | --taskName | タスク名。 タスクフローには適用されません。 |
taskType | -t | --taskType | タスクのタイプ。必須。 以下のいずれかの値を使用します。 - - DMASK。マスキングタスク。
- - DRS。レプリケーションタスク。
- - DSS。同期タスク。
- - MTT。マッピングタスク。
- - PCS。PowerCenterタスク。
- - Workflow。リニアタスクフロー。
- - MI_TASK。ファイル取り込みとレプリケーション
- - TASKFLOW。タスクフロー。
|
parameterSetUniqueName | -pun | --parameterSetUniqueName | パラメータセットの一意の名前。タスクフローに使用できます。 |
parameterDir | -pd | --parameterDir | パラメータファイルのディレクトリ。parameterFileに含まれます。デフォルトは次のとおりです: <SecureAgentInstallDir>/apps/Data_Integration_Server/data/userparameters |
parameterFile | -pf | --parameterFile | パラメータファイル。マッピングタスクに使用できます。 |
waitFlag | -w | --waitFlag | 待機フラグ。ジョブの完了を待機するか、ジョブをバックグラウンドで実行するかを決定します。 |
insecure | -k | --insecure | 非セキュアモード。 |
instanceName | -in | --instanceName | タスクフロー名に追加されるカスタム名。 |
ジョブステータスコード
ジョブが成功すると、RunAJobユーティリティから0（成功を表す値）が返されます。ジョブが失敗した場合はエラーが返されます。
このユーティリティから返されるステータスコードは次のとおりです。
コード | 説明 |
|---|
-1 | 例外 |
0 | 成功 |
1 | 警告 |
2 | 待機なし |
3 | 失敗 |
4 | タイムアウト |
5 | エラー |
6 | 実行中 |
7 | 起動失敗 |
コマンドに必須のパラメータが含まれていない場合や、含まれていても無効な場合は、エラーメッセージが表示されて、そのREST API呼び出しは実行されません。