操作パラメータ構成では、オフラインパイプラインの変数に値を割り当てます。これにより、ノードのスケジューリング中にパラメータ変数が対応する変数値に自動的に置き換えられます。このトピックでは、オフラインパイプラインの操作パラメータを構成する方法について説明します。
手順
Dataphin ホームページの上部ナビゲーションバーで、[開発] > [Data Integration] を選択します。
上部ナビゲーションバーで、プロジェクトを選択します(開発-本番プロジェクトの場合は、環境も選択する必要があります)。
左側のナビゲーションウィンドウで、[統合] > [バッチパイプライン] を選択します。[バッチパイプライン] リストで、ターゲットタスクの名前をクリックします。
タスクタブで、右側の [プロパティ] をクリックして、[プロパティ] パネルを開きます。
[スキャン構成] タブをクリックし、[ランタイムパラメータ] セクションで関連パラメータを設定します。
式
${variable name}を使用してオフライン統合パイプラインで構成されたパラメータは、[ランタイムパラメータ] セクションに表示されます。ランタイムパラメータリストで、パラメータタイプを変更し、パラメータに値を割り当てることができます。パラメーター
説明
パラメーター名
オフラインパイプラインで定義されたパラメータ名です。変数名には数字、文字、およびアンダースコア(_)のみを含め、長さは 32 文字以下にすることをお勧めします。
パラメータータイプ
[グローバル変数]、[名前空間変数]、[ローカル変数]、[クロスノード変数]、[固定値] タイプが含まれます。詳細については、「変数の分類」をご参照ください。
複数のパラメータを選択するか、[すべて選択] をクリックした後、パラメータリストの下部にある [パラメータタイプの変更] をクリックして、パラメータタイプを一括変更します。
パラメーター値
グローバル変数:グローバル変数で定義された変数値がデフォルトで設定されており、変更できません。詳細については、「グローバル変数を作成する」をご参照ください。
スペース名変数:パラメータ値はスペース名です。
ローカル変数:最大 258 文字までサポートされているか、空の値に設定できます。日付と時刻を入力するには、リストから式を選択または参照できます。詳細については、「変数の割り当て」をご参照ください。
クロスノード変数:アップストリームの依存関係を設定した後、アップストリームからクロスノード出力パラメータをパラメータ値として選択できます。
非変数:定義ではサポートされていません。
説明権限管理が有効になっているグローバル変数を参照する場合、システムは現在のユーザーに権限があるかどうかを自動的に検証します。権限のないグローバル変数は、
アイコンでマークされます。[権限をリクエスト] をクリックして [権限管理] > [変数権限管理] ページに移動し、権限をリクエストできます。
変数の分類
Dataphin には次のタイプの変数があります。
変数タイプ | 説明 |
グローバル変数 | Dataphin の [計画] > [共通ビジネスロジック] > [グローバル変数] で事前定義されており、テナント内の任意のノードまたはコードで参照できる変数です。システムには、 説明
|
スペース名変数 |
説明 スペース名変数は、他のタイプの変数に変換できません。 |
ローカル変数 |
重要
|
クロスノード変数 | アップストリームノードから現在のオブジェクトノードに渡される変数を指します。次のシナリオで使用できます。
重要 クロスノードパラメータ変数を導入した後、現在のノードのデータバックフィルを実行する場合は、クロスノードパラメータを出力するアップストリームノードと現在のノードの両方を同時にバックフィルすることをお勧めします。 |
変数割り当て
日付と時刻の割り当て
ローカル変数に値を割り当てるときに、日付と時刻を入力する必要がある場合は、次の形式を選択または参照できます。
${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 |