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

Dataphin:オフラインタスクの実行時パラメーターの設定

最終更新日:Jan 14, 2026

実行時パラメーターを設定して、オフラインタスクの変数に値を割り当てることができます。ノードがスケジュールされると、パラメーターは自動的に割り当てられた値に置き換えられます。このトピックでは、MaxCompute SQL ノードを例に、ノードパラメーターの設定方法と使用方法について説明します。

手順

  1. Dataphin ホームページの上部ナビゲーションバーで、[開発] > [データ開発] を選択します。

  2. [開発] ページの上部ナビゲーションバーから [プロジェクト] を選択します(開発プロダクションモードでは、[環境] を選択する必要があります)。

  3. 左側のナビゲーションウィンドウで、[データ処理] > [スクリプトタスク] を選択します。

  4. コンピューティングタスクリストで、ターゲットのコンピューティングタスクをクリックして、対応するコンピューティングタスクタブを開きます。

  5. 右側のサイドバーにある [プロパティ] をクリックして [プロパティ] パネルを開き、[ランタイムパラメーター] セクションで次のパラメーターを構成します。

    • 入力パラメーター

      スクリプトタスクで ${variable_name} 式を使用して設定したパラメーターは、[実行時パラメーター] セクションに表示されます。このセクションでは、パラメータータイプを変更したり、パラメーターに値を割り当てたりすることができます。

      パラメーター

      説明

      パラメーター名

      コードエディタで定義されたパラメーター名です。変数名には、数字、文字、およびアンダースコア(_)のみを含めることができ、長さは 32 文字を超えることはできません。

      [パラメータータイプ]

      パラメータータイプには、[グローバル変数][名前空間変数][ローカル変数][ノード間変数][固定値] があります詳細については、「変数の分類」をご参照ください。

      複数のパラメーターを選択するか、[すべて選択] をクリックした後、パラメーターリストの下部にある [パラメータータイプの変更] をクリックして、パラメータータイプを一括変更します。

      パラメーター値

      • グローバル変数: グローバル変数で定義された変数値がデフォルトで設定されており、設定できません。詳細については、「グローバル変数を作成する」をご参照ください。

      • スペース名変数: パラメーター値はスペース名です。

      • ローカル変数:値は最大 258 文字まで、または空にすることができます。日時を入力するには、リストから式を選択または参照します。詳細については、「変数の割り当て」をご参照ください。

      • クロスノード変数: アップストリームの依存関係を設定した後、アップストリームからクロスノード出力パラメーターをパラメーター値として選択できます。

      • 非変数: 定義はサポートされていません。

      説明

      権限管理が有効になっているグローバル変数を参照する場合、システムは現在のユーザーに権限があるかどうかを自動的に検証します。権限のないグローバル変数には image アイコンが付きます。[権限をリクエスト] をクリックすると、[権限管理] > [変数権限管理] ページにジャンプして権限をリクエストできます。

    • ノード間出力パラメーター

      重要
      • Python、SQL、および Shell コンピューティングタスクのみが、クロスノード出力パラメーターの定義をサポートしています。

      • 統合タスク、コンピューティングタスク、標準/階層ディメンション論理テーブル、およびファクト論理テーブルは、入力パラメーターとしてクロスノード変数パラメーターをサポートしています。

      このオブジェクトノードの直接のダウンストリームノードに渡される変数パラメーターは、このリストであらかじめ宣言および定義されている必要があります。宣言されていない出力変数はシステムによって無視されます。宣言されていてもコード内で値が割り当てられていない変数は、構成されたデフォルト値を使用します。コード編集領域では、右クリックしてメニューから [クロスノードパラメーターの設定] を選択することで、変数パラメーターに値を割り当てることができます。

      説明
      • 複数のクロスノード出力パラメーターを追加するには、[+ パラメーターの追加] をクリックします。

      • クロスノード出力パラメーターリストはバッチ操作をサポートしています。クロスノード出力パラメーターを選択またはすべて選択した後、image.png をクリックして一括削除を実行できます。

      パラメーター

      説明

      パラメーター名

      長さは 32 文字を超えることはできず、数字、文字、およびアンダースコア(_)のみがサポートされます。

      パラメーターの説明

      パラメーターの簡単な説明(128 文字以内)。

      デフォルト値

      • 変数に値が割り当てられていない場合に使用されるデフォルト値。クロスノード出力パラメーターに値を割り当てるには、「クロスノード出力パラメーターの割り当て」をご参照ください。

      • ダウンストリームノードがアップストリームノードのクロスノード出力パラメーターを参照し、アップストリームノードを同じデータバックフィルインスタンスに含めずにダウンストリームノードでデータバックフィル操作を実行する場合、ダウンストリームノードのクロスノード入力パラメーターは、アップストリームノードの過去 N 日間の操作レコードから値を取得します。操作レコードが存在しないか、N 日を超えている場合は、デフォルト値が使用されます。直近の N 日間(N)のデフォルトは 15 日間です。

      • データバックフィルを実行する場合は、アップストリームノードとダウンストリームノードの両方を選択することをお勧めします。アップストリームノードコードがクロスノードパラメーターに値を割り当てない場合、ダウンストリームノードもデフォルト値を使用します。

  6. [OK] をクリックして、コンピューティングタスクの [ランタイムパラメーター] 構成を完了します。