すべてのプロダクト
Search
ドキュメントセンター

DataWorks:パラメーターノード

最終更新日:Mar 27, 2025

パラメーターノードは、特殊なタイプの仮想ノードです。このタイプのノードは、ワークフロー内のパラメーターを管理し、ノード間でパラメーターを渡すために使用されます。パラメーターノードを使用すると、定数パラメーターと変数パラメーターを管理し、先祖ノードのパラメーターを透過的に渡すことができます。パラメーターを使用する必要があるノードは、パラメーターノードからパラメーターを取得できます。このトピックでは、パラメーターノードを作成する方法について説明します。

ノードの概要

パラメーターノードは、コンピューティングタスクを実行しない仮想ノードです。パラメーターノードは、ノード間でパラメーターを渡し、ワークフロー内のパラメーターを管理するために使用されます。

  • ノード間のパラメーターの受け渡し

    ワークフロー内のノード A が先祖ノードの出力パラメーターを取得する必要がある場合は、パラメーターノードを作成し、パラメーターノードをノード A の先祖ノードとして、ノード A の先祖ノードの子孫ノードとして使用できます。次に、ノード A に必要なすべてのパラメーターをパラメーターノードに追加します。このようにして、ノード A はパラメーターノードから必要なすべてのパラメーターを取得できます。

    上の図では、Sq_MySQL_G ノードは Sq_MySQL_B ノードと Sq_MySQL_E ノードの出力パラメーターを取得する必要があります。パラメーターノードが作成され、Sq_MySQL_B ノードと Sq_MySQL_E ノードの子孫ノードとして使用されます。Sq_MySQL_G ノードに必要なすべてのパラメーターがパラメーターノードに追加されます。次に、Sq_MySQL_G ノードが子孫ノードとして使用され、パラメーターノードの出力パラメーターを取得します。Sq_MySQL_G ノードは、パラメーターノードを使用することで、Sq_MySQL_B ノードと Sq_MySQL_E ノードのすべてのパラメーターを取得できます。

  • パラメーター管理

    ワークフロー内のノードが特定の定数パラメーターと変数パラメーターを使用する必要がある場合は、パラメーターノードを作成し、パラメーターノードをノードの先祖ノードとして使用できます。次に、ノードに必要なすべてのパラメーターをパラメーターノードに追加します。このようにして、ノードはパラメーターノードから必要なすべてのパラメーターを取得できます。パラメーターノードを使用すると、ワークフローで使用されるすべてのパラメーターを一元管理できます。

    上の図では、Sq2_MySQL_ASq2_MySQL_CSq2_MySQL_DSq2_MySQL_ESq2_MySQL_F ノードは特定のパラメーターを使用する必要があります。パラメーターノードが作成され、上記のノードの先祖ノードとして使用されます。パラメーターノードを使用して、上記のノードの出力パラメーターを取得し、パラメーターノードに対応する変数パラメーターまたは定数パラメーターを構成できます。

前提条件

  • 使用する RAM ユーザーがワークスペースに追加されていること。

    RAM ユーザーを使用してタスクを開発する場合は、RAM ユーザーをメンバーとしてワークスペースに追加し、[開発] ロールまたは [ワークスペース管理者] ロールを RAM ユーザーに割り当てる必要があります。ワークスペース管理者ロールには、必要以上の権限があります。ワークスペース管理者ロールを割り当てる場合は注意してください。メンバーを追加してロールを割り当てる方法の詳細については、「ワークスペースメンバーを追加し、ロールを割り当てる」をご参照ください。

  • サーバーレス リソースグループがワークスペースに関連付けられていること。詳細については、「サーバーレス リソースグループを使用する」ディレクトリのトピックをご参照ください。

  • パラメーターノードでタスクを開発する前に、パラメーターノードが作成されていること。詳細については、「タスクノードを作成する」をご参照ください。

注意事項

ノードがパラメーターノードのパラメーターを使用する必要がある場合、ノードはパラメーターノードの直接の子孫ノードである必要があります。

手順 1:パラメーターノードを使用してタスクを開発する

パラメーターノードには、定数、変数、またはパススルー変数タイプのパラメーターを追加できます。次のタブでは、上記のタイプのパラメーターを追加する方法について説明します。

定数パラメーターを追加する

定数パラメーターの値は固定されており、パラメーターノードで直接構成できます。

  1. パラメーターノードの構成タブの左上隅にある [追加] をクリックして、パラメーターを追加します。

  2. 定数パラメーターを構成します。次の表にパラメーターを示します。

    パラメーター

    説明

    パラメーター

    パラメーターの名前を指定します。

    説明

    このパラメーターは、子孫ノードにパラメーターを追加するときに使用されます。

    パラメータータイプ

    ドロップダウンリストから [定数] を選択します。

    ビジネス要件に基づいてパラメーターの値を指定します。

    説明

    ビジネス要件に基づいてパラメーターの説明を入力します。

  3. 定数パラメーターを構成した後、[アクション] 列の [保存] をクリックしてパラメーターを保存します。

    image

変数パラメーターを追加する

変数パラメーターの値は変数です。システム時刻などの変数を使用する場合は、[パラメータータイプ] パラメーターを [変数] に設定します。

  1. パラメーターノードの構成タブの左上隅にある [追加] をクリックして、パラメーターを追加します。

  2. 変数パラメーターを構成します。次の表にパラメーターを示します。

    パラメーター

    説明

    パラメーター

    パラメーターの名前を指定します。

    説明

    このパラメーターは、子孫ノードにパラメーターを追加するときに使用されます。

    パラメータータイプ

    ドロップダウンリストから [変数] を選択します。

    ビジネス要件に基づいてパラメーターの値を指定します。

    説明

    変数パラメーターの詳細については、「スケジューリングパラメーターのサポートされている形式」をご参照ください。

    説明

    ビジネス要件に基づいてパラメーターの説明を入力します。

  3. 変数パラメーターを構成した後、[アクション] 列の [保存] をクリックしてパラメーターを保存します。

    image

パススルー変数パラメーターを追加する

パススルー変数は、パラメーターノードの先祖ノードの出力パラメーターをパラメーターノードの子孫ノードに透過的に渡すために使用されます。パススルー変数タイプのパラメーターを追加する場合は、[値] パラメーターをパラメーターノードの先祖ノードの出力パラメーターに設定できます。

  1. パラメーターノードの構成タブの右側ナビゲーションで、[プロパティ] をクリックします。[プロパティ] タブで、[スケジューリングの依存関係] をクリックします。[スケジューリングの依存関係] タブの [ノードの依存関係] セクションで、[依存関係の追加] をクリックして、パラメーターを渡すノードを上流の依存関係として構成します。

    image

  2. 依存関係を構成した後、[スケジューリングパラメーター] セクションに移動し、[パラメーターの追加] をクリックしてパラメーターを追加します。次の表にパラメーターを示します。

    1. パラメーターの名前を指定します。

    2. image アイコンをクリックして、パラメーターノードの先祖ノードの出力パラメーターを検索し、出力パラメーターを子孫ノードのカスタムパラメーターに関連付けます。image

  3. パラメーターを構成した後、[プロパティ] タブを閉じて、パラメーターノードの構成タブに移動します。パラメーターノードの構成タブで、[追加] をクリックして、パススルー変数パラメーターを追加します。次の表にパラメーターを示します。

    パラメーター

    説明

    パラメーター

    パラメーターの名前を指定します。

    説明

    このパラメーターは、子孫ノードにパラメーターを追加するときに使用されます。

    パラメータータイプ

    ドロップダウンリストから [パススルー変数] を選択します。

    [プロパティ] タブで関連付けた先祖ノードのパラメーターを選択します。

    説明

    ビジネス要件に基づいてパラメーターの説明を入力します。

  4. パススルー変数パラメーターを構成した後、[アクション] 列の [保存] をクリックしてパラメーターを保存します。

    image

パラメーターノードのパラメーターを構成した後、ノードのスケジューリングプロパティを構成します。詳細

手順 2:パラメーターノードのパラメーターを使用する

パラメーターノードを構成した後、パラメーターノードの子孫ノードはパラメーターノードのパラメーターを直接使用できます。これにより、パラメーターの一元管理が容易になり、子孫ノードのタスク開発効率が向上します。

説明

パラメーターノードの子孫ノードがパラメーターノードのパラメーターを使用するには、子孫ノードのスケジューリングパラメーターにパラメーターを追加して、パラメーターをパラメーターノードに関連付ける必要があります。

  1. 先祖ノードのパラメーターをパラメーターノードに関連付けます。

    1. パラメーターノードの構成タブの右側ナビゲーションで、[プロパティ] をクリックします。[プロパティ] タブで、[スケジューリングの依存関係] をクリックします。[スケジューリングの依存関係] タブの [ノードの依存関係] セクションで、[依存関係の追加] をクリックして、パラメーターノードを上流の依存関係として構成します。

      image

    2. 依存関係を構成した後、[スケジューリングパラメーター] セクションに移動し、[パラメーターの追加] をクリックしてパラメーターを追加します。次の表にパラメーターを示します。

      1. パラメーターの名前を指定します。

      2. image アイコンをクリックして、パラメーターノードの先祖ノードの出力パラメーターを検索し、出力パラメーターをパラメーターノードに関連付けます。

        image

  2. パラメーターを構成した後、ノードスクリプトを変更するときに ${パラメーター名} を使用して、パラメーターノードから渡されたパラメーターを取得して使用できます。

手順 2:パラメーターノードをデプロイし、O&M 操作を実行する

  1. ノードコードとスケジューリングプロパティを構成した後、パラメーターノードとその先祖ノードと子孫ノードを本番環境にデプロイします。詳細については、「ノードまたはワークフローのデプロイ」をご参照ください。

  2. デプロイが完了したら、[オペレーションセンター][自動トリガーノード] ページに移動して、デプロイされたノードを表示し、ノードで O&M 操作を実行します。システムは、構成したスケジューリングプロパティに基づいて、ノードを定期的に実行します。詳細については、「オペレーションセンターの概要」をご参照ください。