パラメーターノードは、ワークフロー内でパラメーターを管理し、ノード間でパラメーターを受け渡すための仮想ノードです。定数パラメーター、変数パラメーター、先祖ノードのパラメーターの透過的パススルーをサポートします。
背景情報
パラメーターノードは、計算タスクを実行しない仮想ノードです。ノード間でパラメーターを受け渡し、ワークフロー内のパラメーターを管理します。
-
[ノード間のパラメーターの受け渡し]
ワークフロー内のノードが先祖ノードの出力パラメーターを必要とする場合は、パラメーターノードを仲介として作成します。それらの先祖ノードの子孫として、かつターゲットノードの先祖として配置し、必要なすべてのパラメーターを追加します。
上の図では、sql_7 ノードが sql_1、sql_3、sql_4 ノードの出力パラメーターを必要としています。パラメーターノードがそれらの間に配置され、必要なすべてのパラメーターを収集して sql_7 に転送します。 -
[パラメーター管理]
ワークフロー内の複数のノードが定数パラメーターまたは変数パラメーターを共有する場合は、パラメーターノードを共通の先祖として作成し、共有するすべてのパラメーターを追加します。これにより、ワークフローのパラメーター管理が一元化されます。
上の図では、sql_3、sql_4、sql_5、sql_7 ノードが、それらの先祖として機能する共通のパラメーターノードを通じてパラメーターを共有しています。
注意事項
ノードがパラメーターノード内のパラメーターを使用する場合、そのノードはパラメーターノードの直接の子孫ノードである必要があります。
使用制限
対応リージョン：中国 (杭州)、中国 (上海)、中国 (北京)、中国 (深圳)、中国 (成都)、中国 (香港)、日本 (東京)、シンガポール、マレーシア (クアラルンプール)、インドネシア (ジャカルタ)、ドイツ (フランクフルト)、英国 (ロンドン)、米国 (シリコンバレー)、米国 (バージニア)。
パラメーターノードの作成
DataStudioページに移動します。
DataWorks コンソールにログインします。 左側のナビゲーションウィンドウで、 を選択します。 表示されるページで、ドロップダウンリストから目的のワークスペースを選択し、[DataStudioに移動] をクリックします。
-
データ開発 ページで、
アイコンにマウスポインターを合わせ、 を選択します。または、ワークフローを開き、汎用 を右クリックして、 を選択します。
-
ノードの作成 ダイアログボックスで、 名前 を入力し、 パス を選択します。
-
確認 をクリックします。
パラメーターノードのスケジューリングプロパティの構成
パラメーターノードを作成したら、ビジネス要件に基づいてスケジューリングプロパティを構成します。
スケジューリングプロパティには、基本プロパティ、時間プロパティ、リソースプロパティ、スケジューリングの依存関係が含まれます。パラメーターノードはデータ開発タスクを実行せず、パラメーターの管理と受け渡しのみを行うため、スケジューリングの依存関係には特に注意が必要です。
-
ノードがパラメーターノード内のパラメーターを使用する場合、そのノードはパラメーターノードの直接の子孫ノードである必要があります。
-
パラメーターを透過的にパススルーする必要がある先祖ノードは、パラメーターノードの先祖ノードである必要があります。
パラメーターノードのスケジューリングプロパティの構成方法の詳細については、「基本プロパティの構成」、「時間プロパティの構成」、「リソースプロパティの構成」、「同一サイクルのスケジューリング依存関係の構成」をご参照ください。
パラメーターノードへのパラメーターの追加
スケジューリングプロパティを構成したら、管理またはパススルーするパラメーターをパラメーターノードに追加します。
-
パラメーターノードの構成ページで、 パラメーターの作成 をクリックします。
-
パラメーター名、タイプ、値、説明 を設定し、 保存 をクリックします。
ページ上部の注意書きには、これらのパラメーターを参照するノードは、このパラメーターノードの直接の子孫である必要があることが記載されています。パラメータータイプには、定数、変数、パススルー変数 があります。
-
定数：パラメーターの値は固定です。
-
変数：パラメーターの値は動的です。現在時刻などのシステム変数を使用する必要がある場合は、このタイプを選択します。サポートされている形式の詳細については、「スケジューリングパラメーターのサポートされている形式」をご参照ください。
-
パススルー変数：直接の先祖ノードの出力パラメーターを子孫ノードに受け渡します。このタイプの場合、このパラメーターノードの直接の先祖ノードから利用可能なすべての出力パラメーターのリストから値を選択します。
-
次のステップ：パラメーターノード内のパラメーターの使用
パラメーターノードを構成すると、その子孫ノードはパラメーターを直接使用できるようになり、一元化されたパラメーター管理とより効率的なタスク開発が可能になります。
これらのパラメーターを使用するには、子孫ノードの入力パラメーターとして設定し、ノードコード内で直接参照できるようにします。
-
パラメーターを子孫ノードの入力パラメーターとして設定します。
子孫ノードで、 セクションに移動します。[入力パラメーター] サブセクションで、 追加 をクリックします。パラメーター名を入力し、値のソースを選択して、 [保存] をクリックします。設定内容は次のとおりです。
-
パラメーター名：子孫ノードで使用するパラメーターの名前です。パラメーター名はパラメーターノードで確認できます。
-
値のソース：子孫ノードで使用するパラメーターのソースです。
切り捨てられたパラメーター情報にマウスポインターを合わせると、完全な詳細が表示されます。パラメーターノードのパラメーターは、 [パラメーターノードの出力名:パラメーター名] の形式で表示されます。必要なパラメーター名で終わるソース名を選択します。
-
-
子孫ノードのコードでパラメーターを使用します。