job execute

job execute コマンドは、1 つ以上のジョブを実行します。ジョブの実行後、ジョブ名とジョブ ID が次の形式で返されます。

<JobName=JobID>

使用方法

job execute --j JobNames --f JobPropertyFile --i PollInterval --d ReportDelimiter --n NotificationEmails --o OptionPropertyFile --r ReportTrueOrFalse --t Timeout --w WaitTrueOrFalse --l FileOverrides --v VerboseTrueOrFalse
必須引数説明
はい--j JobNames実行する 1 つ以上のジョブの名前を指定します。複数のジョブを指定する場合は、それぞれのジョブをカンマで区切ってください。ジョブがリストの順番に実行されます。ジョブ名にスペースが含まれる場合は、名前を引用符で囲みます。
ヒント: 使用するデータフローの名前が正確にわからない場合は、dataflow list コマンドを使用してデータフロー名のリストを取得できます。
いいえ--f JobPropertyFileジョブ プロパティ ファイルへのパスを指定します。ジョブ プロパティ ファイルには、ジョブの実行を制御する引数が含まれています。詳細については、「ジョブ プロパティ ファイルの使用」を参照してください。
いいえ--i PollInterval--w を true に設定した場合、完了したジョブを確認する間隔をこのオプションで秒単位で指定します。デフォルトは 5 です。
いいえ--d ReportDelimiter--w true または --r true も指定した場合、レポート出力で使用する区切り文字を設定します。デフォルトは、パイプ記号 ( | ) です。
いいえ--n NotificationEmails電子メール アドレスを 1 つ以上指定します。このメール アドレスによって、Management Console で設定されている、ジョブのステータスに関する通知を受信します。各電子メールアドレスの区切りにはカンマを使用します。
いいえ--o OptionPropertyFile

フロー オプション プロパティ ファイルのパスを指定します。フロー オプション プロパティ ファイルを使用すると、フローのステージ オプションを設定できます。プロパティ ファイルを使用してフロー オプションを設定するには、実行時にステージ オプションをエクスポーズするようにフローを構成する必要があります。詳細については、「フロー実行時オプションの追加」を参照してください。

以下に、Assign GeoTAX Info ステージを含むフローのフロー オプション プロパティ ファイルの例を示します。

OutputCasing=U
UseStreetLevelMatching=N
TaxKey=T
Database.GTX=gsl
いいえ--r ReportTrueOrFalseジョブについての詳細レポートを返すには、true を指定します。このオプションは、--w true も指定している場合にのみ機能します。レポートには、次の情報が含まれます。
  • 位置 1 - ジョブの名前
  • 位置 2 - ジョブ プロセス ID
  • 位置 3 - ステータス
  • 位置 4 - 開始日時 (MM/DD/YYYY HH:MM:SS)
  • 位置 5 - 終了日時 (MM/DD/YYYY HH:MM:SS)
  • 位置 6 - 成功したレコードの数
  • 位置 7 - 失敗したレコードの数
  • 位置 8 - 形式に誤りのあるレコードの数
  • 位置 9 - 現在使用されていない

例を次に示します。

MySimpleJob|4|succeeded|04/09/2010 14:50:47|04/09/2010 14:50:47|100|0|0|

情報は、--d 引数で指定された区切り文字で区切られて出力されます。

いいえ--t Timeout同期モードのタイムアウト値を秒単位で設定します。デフォルト値は 3600 です。
いいえ--w WaitTrueOrFalse同期モードでジョブを 1 つずつ実行するには、true を指定します。すべてのジョブを同時に実行するには false を指定します。デフォルトは false です。
いいえ--l FileOverrides入力/出力ファイルおよびファイル形式をオーバーライドします。詳細については、ジョブ ファイルのオーバーライドと ファイル形式のオーバーライドを参照してください。
いいえ--v VerboseTrueOrFalseジョブを実行するために使用する引数に関する情報と、ジョブ実行に関するその他の詳細情報を返すには、true を指定します。

例

この例では、Example1 というジョブを実行します。カンマ区切りレポートが返されます。--w true を指定しているのは、実行中のジョブが 1 つだけでもレポートを返すように要求するためです。Read From File ステージで指定されている入力ファイルは、このステージで指定されているファイルから、CandidateHomes2.csv という名前の別のファイルに変更されます。詳細な出力も返されます。

job execute --j Example1 --w true --d "," --r true --l "Read from File=file://e:/SampleDataflows/DataFiles/DataFiles/CandidateHomes2.csv” --v true