パラメーターノードは、特殊なタイプの仮想ノードです。このタイプのノードは、ワークフロー内のパラメーターを管理し、ノード間でパラメーターを渡すために使用されます。パラメーターノードを使用すると、定数および変数パラメーターを管理し、先祖ノードのパラメーターを透過的に渡すことができます。パラメーターを使用する必要があるノードは、パラメーターノードからパラメーターを取得できます。このトピックでは、パラメーターノードの作成方法について説明します。
背景情報
パラメーターノードは仮想ノードです。コンピューティングタスクは実行しません。ノード間でパラメーターを渡し、ワークフロー内のパラメーターを管理するために使用されます。
-
ノード間のパラメーター渡し
ワークフロー内のノード A がその先祖ノードの出力パラメーターを取得する必要がある場合、パラメーターノードを作成し、それをノード A の先祖ノード、かつ、対象の先祖ノードの子孫ノードとして設定します。次に、ノード A に必要なすべてのパラメーターをパラメーターノードに追加します。これにより、ノード A は必要なすべてのパラメーターをパラメーターノードから取得できます。
上の図では、sql_7 ノードは sql_1、sql_3、および sql_4 ノードの出力パラメーターを取得する必要があります。パラメーターノードが作成され、sql_1、sql_3、および sql_4 ノードの子孫ノードとして、また sql_7 ノードの先祖ノードとして使用されます。sql_7 ノードに必要なすべてのパラメーターがパラメーターノードに追加され、sql_7 ノードは必要なすべてのパラメーターをパラメーターノードから取得できます。 -
パラメーター管理
ワークフロー内のノードがいくつかの定数および変数パラメーターを使用する必要がある場合、パラメーターノードを作成し、それをこれらのノードの先祖ノードとして使用できます。次に、これらのノードに必要なすべてのパラメーターをパラメーターノードに追加します。これにより、これらのノードは必要なすべてのパラメーターをパラメーターノードから取得できます。パラメーターノードは、ワークフローで使用されるすべてのパラメーターの集中管理を容易にします。
上の図では、sql_3、sql_4、sql_5、および sql_7 ノードはいくつかのパラメーターを使用する必要があります。パラメーターノードが作成され、sql_3、sql_4、sql_5、および sql_7 ノードの先祖ノードとして使用されます。これらのノードに必要なすべてのパラメーターがパラメーターノードに追加され、これらのノードは必要なすべてのパラメーターをパラメーターノードから取得できます。
注意事項
ノードがパラメーターノード内のパラメーターを使用する必要がある場合、そのノードはパラメーターノードの直接の子孫ノードである必要があります。
制限事項
サポートされているリージョン：中国 (杭州)、中国 (上海)、中国 (北京)、中国 (深セン)、中国 (成都)、中国 (香港)、日本 (東京)、シンガポール、マレーシア (クアラルンプール)、インドネシア (ジャカルタ)、ドイツ (フランクフルト)、イギリス (ロンドン)、米国 (シリコンバレー)、および米国 (バージニア)。
パラメーターノードの作成
DataWorks コンソールにログインします。対象のリージョンで、左側のナビゲーションウィンドウで をクリックします。ドロップダウンリストからワークスペースを選択し、入力 データ開発 をクリックします。
-
DataStudio ページで、
アイコンにポインターを合わせ、 を選択します。または、ワークフローを開き、General を右クリックして、 を選択します。
-
Create Node ダイアログボックスで、Name を入力し、Path を選択します。
-
OK をクリックします。
パラメーターノードのスケジューリングプロパティの設定
パラメーターノードを作成した後、ビジネス要件に基づいてパラメーターノードのスケジューリングプロパティを設定できます。
スケジューリングプロパティには、基本プロパティ、時間プロパティ、リソースプロパティ、スケジューリング依存関係が含まれます。パラメーターノードはデータ開発タスクを実行しません。パラメーターの管理と透過的なパラメーターの受け渡しにのみ使用されます。したがって、パラメーターノードに設定されるスケジューリング依存関係には特に注意を払う必要があります。
-
ノードがパラメーターノード内のパラメーターを使用する必要がある場合、そのノードはパラメーターノードの子孫ノードである必要があります。
-
パラメーターを透過的に渡す必要がある先祖ノードは、パラメーターノードの先祖ノードである必要があります。
パラメーターノードのスケジューリングプロパティの設定方法の詳細については、「基本プロパティの設定」、「時間プロパティの設定」、「リソースプロパティの設定」、および「同一サイクルスケジューリング依存関係の設定」をご参照ください。
パラメーターノードへのパラメーターの追加
パラメーターノードのスケジューリングプロパティを設定した後、管理および透過的に渡したいパラメーターをパラメーターノードに追加して、その後の管理と使用に備えることができます。このセクションでは、その手順を詳しく説明します。
-
パラメーターノードの設定ページで、Add Parameter をクリックします。
-
Parameter name、Type、Value、および Description を設定し、Save をクリックします。
ページ上部の注記には、これらのパラメーターを参照するノードは、このパラメーターノードの直接の子孫ノードでなければならないことが示されています。パラメーターのタイプには、Constant、Variable、および Pass-through Variable があります。
-
Constant：パラメーターの値は固定です。
-
Variable：パラメーターの値は動的です。現在時刻などのシステム変数を使用する必要がある場合は、このタイプを選択します。サポートされているフォーマットの詳細については、「スケジューリングパラメーターでサポートされているフォーマット」をご参照ください。
-
Pass-through Variable：直接の先祖ノードから子孫ノードに出力パラメーターを渡します。このタイプでは、このパラメーターノードの直接の先祖ノードから利用可能なすべての出力パラメーターのリストから値を選択します。
-
次のステップ：パラメーターノード内のパラメーターの使用
パラメーターノードを設定した後、パラメーターノードの子孫ノードは、パラメーターノード内のパラメーターを直接使用できます。これにより、パラメーターの集中管理が容易になり、子孫ノードのタスク開発効率が向上します。
パラメーターノードの子孫ノードがパラメーターノード内のパラメーターを使用する前に、これらのパラメーターを子孫ノードの入力パラメーターとして設定する必要があります。これにより、これらのパラメーターは子孫ノードのコードで直接使用できるようになります。
-
パラメーターを子孫ノードの入力パラメーターとして設定します。
子孫ノードについては、 セクションに移動します。[入力パラメーター] サブセクションで、Add をクリックします。パラメーター名を入力し、値のソースを選択してから、[保存] をクリックします。設定は次のとおりです：
-
パラメーター名：子孫ノードが使用する必要があるパラメーターの名前。パラメーター名はパラメーターノードで確認できます。
-
値のソース：子孫ノードが使用する必要があるパラメーターのソース。
パラメーター情報が完全に表示されない場合は、ポインターを合わせると完全な情報を表示できます。パラメーターノードに追加されたすべてのパラメーターは、パラメーターノードの出力名：パラメーター名 のフォーマットで表示されます。必要なパラメーターの名前で終わるソース名を選択できます。
-
-
子孫ノードのコードでパラメーターを使用します。