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

:変数の設定

最終更新日:Feb 13, 2025

データ管理 (DMS) のタスクオーケストレーション機能は、複数の時間変数をサポートします。 事前定義された時間変数は、タスクまたはタスクフローで参照できます。 この機能により、SQL文が簡素化され、開発効率が向上します。

手順

  1. にログインします。 DMSコンソールV5.0
  2. 上部のナビゲーションバーで、DTS > データ开発 > タスクオーケストレーション (旧).

  3. DMSタスクオーケストレーションページの [無料オーケストレーションタスク] セクションで、[新しいタスクフロー] をクリックします。
  4. [新しいタスクフロー] ダイアログボックスで、[タスクフロー名][説明] パラメーターを設定し、[OK] をクリックします。
  5. 作成したタスクフローの [タスクオーケストレーション] タブで、キャンバス上の空白の領域をクリックします。
  6. 右側のウィンドウで、[変数] タブをクリックします。
    説明 タスクの変数を設定することもできます。 タスクフローに設定されている変数とタスクに設定されている変数には、次の違いがあります。
    • タスクフローに変数を設定する場合、タスクフローの各タスクの変数を参照できます。
    • タスクの変数を設定する場合、変数はタスク内でのみ参照できます。
  7. 必要に応じて、[変数名] および [変数ルール] パラメーターを設定します。
    パラメーター説明
    変数名カスタム変数の名前。
    bizdateは唯一のデフォルトのシステム変数で、タスクが実行された日の前日を示します。 bizdate変数の値は、yyyy-MM-dd形式です。 たとえば、タスクが2019年8月15日に実行された場合、bizdate変数の値は2019-08-14です。
    説明 設定した変数を削除するには、アイコンをクリックしDelete iconます。
    変数ルールカスタム変数の時間形式と時間オフセット設定。 すべてのカスタム変数は、bizdate変数の値に基づいて定義されます。 詳細については、「時間形式」をご参照ください。
    bizdate変数の値にオフセットを設定することもできます。 プラス (+) は後方オフセット時間を示し、マイナス () は前方オフセット時間を示す。 たとえば、- 6 Monthは、タスクが実行される6か月前の時点を示します。
    説明 変数を設定すると、SQL文で ${variable name} 形式で変数を参照できます。 タスクノードの [コンテンツ] タブで、[SQLPreview] をクリックして、変数が期待どおりに設定されているかどうかを確認できます。
  8. [保存] をクリックします。

時間形式

次の表に、カスタム変数の時間形式を定義するために使用できる時間変数を示します。

時間変数説明サンプル形式サンプル値
安野ドミニ (AD)GはADを示す。 GyyyyAD 2021
  • y: タスクが実行される日の年。 yまたはyyyyは、4桁の形式で年を示します。 yyはその年の下2桁を示します。
  • Y: タスクが実行された週の最後の日の年。 週の最後の日は日曜日です。
yyyy2021
M: タスクが実行される月。 Mの有効値: [1,12] 。 MMの有効な値: [01,12]. MM08
  • w: タスクが実行される年の週。 wの有効値: [1,52] 。 wwの有効値: [01,52] 。
  • W: タスクが実行される月の週。 有効な値: [1,5] 。
ww13
  • D: タスクが実行される日。 Dの有効値: [1,365] 。 DDの有効値: [01,365] 。 DDDの有効値: [001,365] 。
  • d: タスクが実行される月の日。 dの有効値: [1,31] 。 dd: [01,31] の有効値。
D360
曜日
  • E: タスクが実行される曜日。 有効な値: 月曜日から日曜日。
  • e: タスクが実行される週の日数。 有効な値: [1,7] 。 1 は月曜日を表します。
    説明 日曜日を週の最初の日としてカウントするには、オフセットを「 + 1日」に設定します。
e1
Ante meridiem (AM) またはpost meridiem (PM)a: タスクが実行される時点が正午の前か後かを示します。 時刻が00:00 ~ 11:59の範囲の場合、戻り値はAMです。時刻が12:00 ~ 23:59の範囲の場合、戻り値はPMです。 aAM
時間
  • H: タスクが実行される時間。 0の値は、その日の最初の時間を示します。 Hの有効値: [0,23] 。 HHの有効値: [00,23] 。
  • h: タスクが実行される半日の時間。 値1は、半日の最初の1時間を示す。 hの有効値: [1,12] 。 hhの有効値: [01,12] 。
  • K: タスクが実行される半日の時間。 0の値は、半日の最初の1時間を示す。 Kの有効値: [0,11] 。 KKの有効値: [00,11] 。
  • k: タスクが実行される日の時間。 値1は、その日の最初の1時間を示します。 kの有効値: [1,24] 。 kkの有効値: [01,24] 。
HH10
m: タスクが実行される時間の分。 mの有効値: [0,59] 。 mmの有効値: [00,59] 。 m27
  • s: タスクが実行される分の秒。
  • S: タスクが実行される分のミリ秒。
ss08
タイムゾーンz: タイムゾーン。 zUTC + 08:00
次の表に、複数の時間変数を使用するサンプルの時間形式を示します。
サンプル形式サンプル値
yyyy-MM-dd2019-08-02
HH:mm:ss11:05:21
yyyyMMdd HH:mm:ss20190802 11:05:21
yyyyMM0120190801