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

Dataphin:オフラインパイプライン操作パラメーターの構成

最終更新日:May 29, 2025

操作パラメータ構成では、オフラインパイプラインの変数に値を割り当てます。これにより、ノードのスケジューリング中にパラメータ変数が対応する変数値に自動的に置き換えられます。このトピックでは、オフラインパイプラインの操作パラメータを構成する方法について説明します。

手順

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

  2. 上部ナビゲーションバーで、プロジェクトを選択します(開発-本番プロジェクトの場合は、環境も選択する必要があります)。

  3. 左側のナビゲーションウィンドウで、[統合] > [バッチパイプライン] を選択します。[バッチパイプライン] リストで、ターゲットタスクの名前をクリックします。

  4. タスクタブで、右側の [プロパティ] をクリックして、[プロパティ] パネルを開きます。

  5. [スキャン構成] タブをクリックし、[ランタイムパラメータ] セクションで関連パラメータを設定します。

    ${variable name} を使用してオフライン統合パイプラインで構成されたパラメータは、[ランタイムパラメータ] セクションに表示されます。ランタイムパラメータリストで、パラメータタイプを変更し、パラメータに値を割り当てることができます。

    パラメーター

    説明

    パラメーター名

    オフラインパイプラインで定義されたパラメータ名です。変数名には数字、文字、およびアンダースコア(_)のみを含め、長さは 32 文字以下にすることをお勧めします。

    パラメータータイプ

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

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

    パラメーター値

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

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

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

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

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

    説明

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

変数の分類

Dataphin には次のタイプの変数があります。

変数タイプ

説明

グローバル変数

Dataphin の [計画] > [共通ビジネスロジック] > [グローバル変数] で事前定義されており、テナント内の任意のノードまたはコードで参照できる変数です。システムには、${bizdate} などの組み込みグローバル変数が最初に用意されています。

説明
  • グローバル変数は、現在、リアルタイムコンピューティングと統合同期タスクをサポートしていません。

  • グローバル変数の設定に関する具体的な操作については、「グローバル変数を作成する」をご参照ください。

スペース名変数

${本番/開発プロジェクト名} および ${本番/開発業務部門名} を指します。

説明

スペース名変数は、他のタイプの変数に変換できません。

ローカル変数

  • 事前に宣言または定義する必要はありません。オフラインパイプラインで ${variable_name} を直接使用して、variable_name という名前のローカル変数を定義できます。

  • 変数名には数字、文字、およびアンダースコア(_)のみを使用し、グローバル変数用に予約されている glb で始めない ことをお勧めします。長さは 32 文字以下にする必要があります。

重要
  • variable_name がグローバル変数名と同じである場合、システムはグローバル変数への参照としてそれを優先します。パラメータ構成でそのタイプをローカル変数に変換できます。

  • variable_name が本番プロジェクトまたは本番業務部門名と同じである場合、システムはそれを強制的にスペース名変数として扱います。

  • ${variable_name} が変数ではなくコードコンテンツの一部である場合、[パラメータタイプ] 構成でこの変数を [非変数] として設定できます。

  • ${variable_name} がクロスノード変数である場合、[パラメータタイプ] 構成でこの変数を [クロスノード変数] として設定できます。

  • ローカル変数のパラメータ値を空の値に設定するには、[パラメータ値] フィールドの [空の値に設定] をクリックします。

クロスノード変数

アップストリームノードから現在のオブジェクトノードに渡される変数を指します。次のシナリオで使用できます。

  • アップストリームノード A が変数 ${var} をダウンストリームノード B に渡し、${var} が B の計算ロジックによって参照されます。

  • アップストリームノード A が変数 ${var} をダウンストリームノード B に渡し、B が ${var} の値に基づいて実行戦略を決定します。

重要

クロスノードパラメータ変数を導入した後、現在のノードのデータバックフィルを実行する場合は、クロスノードパラメータを出力するアップストリームノードと現在のノードの両方を同時にバックフィルすることをお勧めします。

変数割り当て

日付と時刻の割り当て

ローカル変数に値を割り当てるときに、日付と時刻を入力する必要がある場合は、次の形式を選択または参照できます。

  • ${yyyymmdd - 1}:yyyyMMdd 形式の前の営業日。

  • ${yyyy-mm-dd - 1}:yyyy-MM-dd 形式の前の営業日。

  • $[yyyymmdd - 1]:前のスケジューリング日。

  • ${yyyy - 1}:前の営業年。

  • ${yyyymm - 1}:前の営業月。

  • $[yyyymmdd]:現在のスケジューリング日。

  • $[HH - 1/24]:前のスケジューリング時間。

  • $[HH:mm:ss - 1/24/60]:前のスケジューリング分。

  • $[yyyymmdd - 1/24]:日付部分を取得する前のスケジューリング時間。

パラメータ値を構成した後、[プレビュー] をクリックして、パラメータ値プレビューダイアログボックスで [営業日] を選択した後のパラメータ値を表示できます。営業日はデフォルトで現在の営業日に設定されています。日付と時刻の計算ロジックと例については、以下を参照してください。

日付と時刻の計算式

ローカル変数に値を割り当てるときに、日付と時刻の計算を実行する必要がある場合、Dataphin は次のショートカット日付計算演算子をサポートしています。

  • Dataphin は、2 つの日付時刻形式に基づいて計算を提供します

    • 営業日 ${bizdate} に基づく:${(yyyyMMdd|yyyy/MM/dd|yyyy-MM-dd) (+|-) n}

    • 予想実行時間(ノードタスクのスケジュールされた開始時刻)に基づく:${(yyyyMMddHHmmss|yyyy/MM/dd HH:mm:ss|yyyy-MM-dd HH:mm:ss) (+|-) n}

  • 日付と時刻の各部分の識別子

    • :yyyy。

    • :mm(日付と時刻が日粒度のみの場合に使用可能)または MM(日付と時刻が分粒度の場合、分 mm と区別するために大文字を使用する必要があります)。

    • :dd。

    • :HH。

    • :mm。

    • :ss。

  • 日付と時刻の計算の単位(間隔)は日です

    • 1 時間は 1/24、5 時間は 5/24 として表されます。

    • 1 分は 1/24/60、30 分は 30/24/60 として表されます。

参照例

現在の日付

営業日に基づく構成(T-1)

実際の値

予想実行時間に基づく構成(T)

実際の値

2018-01-10

${yyyymmdd}

20180109

$[yyyymmdd]

20180110

2018-01-10

${yyyyMMdd}

20180109

$[yyyyMMdd]

20180110

2018-01-10

${yyyymmdd -1}

20180108

$[yyyymmdd -1]

20180109

2018-01-10

${yyyymmdd -7}

20180102

$[yyyymmdd -7]

20180103

2018-01-10

${yyyy-mm-dd}

2018-01-09

$[yyyy-mm-dd]

2018-01-10

2018-01-10

${yyyy-mm}

2018-01

$[yyyy-mm]

2018-01

2018-01-10

${yyyy-mm -1}

2017-12

$[yyyy-mm -1]

2017-12

2018-01-10

${yyyy}

2018

$[yyyy]

2018

2018-01-10

${yyyy+1}

2019

$[yyyy + 1]

2019

2018-01-10

${yyyy/MM/dd HH:mm:ss}

2018/01/09 00:00:00

$[yyyy/MM/dd HH:mm:ss]

2018/01/10 00:00:00

2018-01-10

${yyyy/MM/dd HH:mm:ss-1/24}

2018/01/08 23:00:00

$[HH:mm:ss-5/24/60]

23:55:00