パラメーターノードは、ビジネスフロー内のパラメーターを管理し、タスクノード間でパラメーターを渡すために使用される特殊なタイプのゼロロードノードです。定数パラメーター、変数パラメーター、および先祖ノードからのパススルーパラメーターをサポートしています。これらのパラメーターを参照する必要があるタスクノードは、パラメーターノードに直接依存させることができます。このトピックでは、パラメーターノードを作成する方法について説明し、DataWorks を使用した効率的なデータ開発を支援します。
背景情報
パラメーターノードは、コンピューティングタスクを実行したりデータを生成したりしないゼロロードノードです。主にノード間のパラメーター渡しとパラメーター管理に使用されます。
ノード間のパラメーター渡し
データ開発フローにおいて、子孫ノードのタスクが異なるレベルにある複数の先祖ノードから出力パラメーターを取得する必要がある場合、パラメーターノードを使用して必要なすべてのパラメーターを統合できます。これにより、子孫ノードをパラメーターノードに直接アタッチして、必要なすべてのパラメーターを取得できます。
上の図では、`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` ノードはすべてパラメーターを使用する必要があります。この場合、パラメーターノードを作成し、各子孫ノードで使用されるパラメーターをそのノードに追加できます。次に、パラメーターを必要とするノードをこのパラメーターノードの子孫としてアタッチします。
注意事項
タスクノードがパラメーターノード内のパラメーターを参照する場合、そのタスクノードはビジネスフロー内でパラメーターノードの直接の子孫である必要があります。タスクノードの上流依存関係としてパラメーターノードを設定する必要があります。
制限事項
サポートされているリージョン：中国 (杭州)、中国 (上海)、中国 (北京)、中国 (深セン)、中国 (成都)、中国 (香港)、日本 (東京)、シンガポール、マレーシア (クアラルンプール)、インドネシア (ジャカルタ)、ドイツ (フランクフルト)、イギリス (ロンドン)、米国 (シリコンバレー)、および米国 (バージニア)。
パラメーターノードの作成
DataStudio ページに移動します。
DataWorks コンソールにログインします。上部のナビゲーションバーで、目的のリージョンを選択します。左側のナビゲーションウィンドウで、を選択します。表示されたページで、ドロップダウンリストから目的のワークスペースを選択し、[データ開発へ] をクリックします。
データ開発 ページで、
アイコンにカーソルを合わせ、 をクリックします。または、ビジネスフローを開き、一般 を右クリックして、 を選択します。
新規ノード ダイアログボックスで、[名前] を入力し、[パス] を選択できます。
[確認] をクリックします。
スケジューリングの構成
パラメーターノードを作成した後、シナリオに基づいてそのスケジューリングプロパティを構成する必要があります。
スケジューリング構成には、基本プロパティ、時間プロパティ、リソースプロパティ、およびスケジューリング依存関係が含まれます。パラメーターノードはデータ処理タスクを実行しません。パラメーター管理とパススルーにのみ使用されます。したがって、パラメーターノードのスケジューリングを構成する際には、そのスケジューリング依存関係に重点を置く必要があります：
パラメーターノードのパラメーターを使用するタスクノードは、パラメーターノードの下流依存関係である必要があります。
パススルーパラメーターを生成する先祖ノードは、パラメーターノードの上流依存関係である必要があります。
スケジューリングの構成方法の詳細については、「基本プロパティの構成」、「時間プロパティの構成」、「リソースプロパティの構成」、および「同一サイクルスケジューリング依存関係の構成」をご参照ください。
パラメーターの追加
パラメーターノードのスケジューリングを構成した後、管理またはパススルーしたいパラメーターを追加します。次の手順に従ってください：
パラメーターノードの編集ページで、[パラメーターの追加] をクリックします。
[パラメーター名]、[タイプ]、[値]、および [説明] を構成し、[保存] をクリックします。
使用可能なパラメータータイプは、定数、変数、および パススルー変数 です。定数：パラメーターは静的フィールドを持ちます。
変数：パラメータータイプを変数に設定して、システム時刻などの変数をパラメーター値として使用できます。変数パラメーターの詳細については、「サポートされているスケジューリングパラメーターのフォーマット」をご参照ください。
パススルー変数：パススルー変数は、主に先祖ノードの出力パラメーターを子孫ノードに渡すために使用されます。パラメーター値には、パラメーターノードのスケジューリング依存関係として指定されている先祖ノードの任意の出力パラメーターを選択できます。
次のステップ：子孫ノードでのパラメーターの使用
パラメーターノードを構成した後、その子孫ノードでパラメーターノードのパラメーターを直接使用できます。これにより、パラメーターを一元管理し、子孫ノードのタスクの開発効率を向上させることができます。
子孫ノードがパラメーターノードのパラメーターを使用する場合、まず子孫ノードのコンテキスト設定でパラメーターを参照する必要があります。その後、タスクコードでパラメーターを使用できます。
子孫ノードのコンテキストを設定します。
子孫ノードの タブで、このノードの入力パラメーター セクションの [追加] をクリックして、必要なパラメーターを追加します。
パラメーターの説明は次のとおりです：パラメーター名：使用するパラメーターの名前です。パラメーター名はパラメーターノードで確認できます。
値のソース：目的のパラメーターノードからソースパラメーターを選択します。
コンテンツが長すぎて完全に表示されない場合は、値のソースをポイントすると完全なソース情報を表示できます。使用可能な値のソースは、現在のノードの先祖ノードからのすべてのパラメーターです。フォーマットは ノード出力名: パラメーター名 です。パラメーター名のサフィックスを使用して、特定の値のソースをすばやく見つけることができます。
子孫ノードのコードでパラメーターを使用します。