DataWorks:ワークフローパラメーター

備考

• 手動でトリガーされるワークフローでは、ODPS SQL ノード、Shell ノード、同期ノードがグローバルパラメーターをサポートしています。 グローバルパラメーターを指定する形式は、ノードタイプによって異なります。 たとえば、グローバルワークフローパラメーターは次のように指定されます： x=y1
  • ODPS SQL ノードのワークフローパラメーターを構成するには、対象のノードをダブルクリックし、右側のナビゲーションウィンドウの [一般] のタブをクリックします。 表示される [一般] タブで、[引数] フィールドに x=aaa を入力します。 ノードが実行されると、ワークフローパラメーターの構成が x=y1 に置き換えられます。 $x を使用して、コードでワークフローパラメーターを参照します。
  • Shell ノードのワークフローパラメーターを構成するには、対象のノードをダブルクリックし、右側のナビゲーションウィンドウの [一般] タブをクリックします。 表示される [一般] タブで、[引数] フィールドに $x を入力します。 ノードが実行されると、ワークフローパラメーターの構成が y1 に置き換えられます。 $1 を使用して、コードでワークフローパラメーターを参照します。
  • 同期ノードのワークフローパラメーターを構成するには、対象のノードをダブルクリックし、右側のナビゲーションウィンドウの [一般] タブをクリックします。 表示される [一般] タブで、[引数] フィールドに -p"-Dx=aaa" を入力します。 ノードが実行されると、ワークフローパラメーターの構成が -p"-Dx=y1 に置き換えられます。 $x を使用して、コードでワークフローパラメーターを参照します。
• 自動トリガーワークフローでは、ODPS SQL ノードのみがグローバルパラメーターをサポートしています。
• パラメーター名と値では、大文字と小文字が区別されます。

ワークフローパラメーターの構成

1. DataWorks コンソールにログインします。 左側のナビゲーションウィンドウで、[ワークスペース] をクリックします。 [ワークスペース] ページで、対象のワークスペースを見つけて、[アクション] 列の[データ分析] をクリックします。
2. DataStudio ページで、左側のナビゲーションウィンドウにある [手動でトリガーされるワークフロー] をクリックします。 対象のワークフローをダブルクリックして、構成ページに移動します。
3. 右側のナビゲーションウィンドウで、 [ワークフローパラメーター] タブをクリックします。 表示される [ワークフローパラメーター] タブで、[パラメーター名] フィールドに [ReplaceMe] 、[値/式] フィールドに ReplaceMe123 を入力します。
4. [保存] をクリックします。

ODPS SQL ノードのワークフローパラメーターの構成

1. [DataStudio] ページで、左側のナビゲーションウィンドウにある [手動でトリガーされるワークフロー] をクリックします。
2. 対象のワークフローを見つけて、MaxCompute> [データ分析] を選択し、既存のすべてのデータ分析ノードを表示します。 対象の ODPS SQL ノードをダブルクリックし、構成ページに移動します。
3. 左側のナビゲーションウィンドウで、[一般] タブをクリックします。 表示される [一般] タブで、[引数] フィールドに ReplaceMe=123 を入力します。

   ワークフローパラメーターは次のように指定されます： ReplaceMe=ReplaceMe123 。 したがって、ワークフローの実行時のこのノードのワークフローパラメーター ReplaceMe には、値 ReplaceMe123 が割り当てられます。

4. ツールバーの アイコンをクリックして、構成を保存します。

Shell ノードのワークフローパラメーターの設定

1. [DataStudio] ページで、左側のナビゲーションウィンドウで [手動でトリガーされるワークフロー] をクリックします。
2. 対象のワークフローを見つけて、[一般] をクリックして既存のすべてのデータ分析ノードを表示します。 対象の Shell ノードをダブルクリックし、構成ページに移動します。
3. 右側のナビゲーションウィンドウで、[一般] タブをクリックします。 表示される [一般] タブで、[引数] フィールドに ${ReplaceMe} を入力します。
   注 パラメーターが正しい形式で入力されていることを確認してください。
4. ツールバーの アイコンをクリックして、構成を保存します。

同期ノードのワークフローパラメーターの構成

1. [DataStudio] ページで、左側のナビゲーションウィンドウにある [手動でトリガーされるワークフロー] をクリックします。
2. 対象のワークフローを見つけて、[データ統合] をクリックし、既存のすべてのデータ統合ノードを表示します。 対象の同期ノードをダブルクリックし、構成ページに移動します。
3. 左側のナビゲーションウィンドウで、[一般] タブをクリックします。 表示される [一般] タブで、[引数] フィールドに -p"ReplaceMe=abc" を入力します。
   注 パラメーターは正しい形式、すなわち、-p"-DParameter name=Parameter value" を入力してください。
4. ツールバーの アイコンをクリックして、構成を保存します。

ワークフローを実行して結果を表示

ワークフローの設定ページで、ツールバーの [実行] アイコンをクリックします。 表示される [パラメーターを入力してください。]というダイアログボックスで、指定した値を ReplaceMe パラメーターに割り当てます。 ワークフローパラメーターの値は、ワークフローの実行時に置き換えられます。

• ODPS SQL ノードを右クリックして [ログの表示] を選択します。 ODPS SQL ノードのワークフローパラメーターに割り当てられた値を表示できます。
• Shell ノードを右クリックして、 [ログ表示] を選択します。 Shell ノードのワークフローパラメーターに割り当てられた値を表示できます。
• 同期ノードを右クリックして [ログの表示] を選択します。 同期ノードのワークフローパラメーターに割り当てられた値を表示できます。

手動でトリガーされたワークフローの [ワークフローパラメーター] タブでワークフローパラメーターに値を割り当てていない場合、本番環境でワークフローを実行するたびに、ワークフローパラメーターに値を割り当てる必要があります。