DataWorks:スケジューリングパラメーターのソースと式

基本概念

スケジューリングパラメーターがどのように値を計算するかは、2 つの時間概念によって決まります。

違いが重要な理由：一般的な ETL ワークフローでは、今日、昨日のデータを処理します。タスクが 2024-03-15 02:00:00 に実行される場合、データタイムスタンプは 2024-03-14 となり、処理対象データのビジネス日付を表します。この 1 日のオフセットが、${...} フォーマットの基礎となります。

スケジューリングパラメーターの値は、タスクインスタンスが生成されるときに決定されます。インスタンスが実際にいつ実行されるかに関係なく、この値は変更されません。

パラメーターフォーマットの選択

DataWorks は 2 種類のカスタム時間パラメーターフォーマットを提供しています。適切なものを選択するには、次の表をご利用ください：

${yyyymmdd} は $[yyyymmdd-1] と同等で、どちらもデータタイムスタンプを生成します。${...} フォーマットは日単位の精度のみです。時間または分レベルの精度が必要な場合は $[...] を使用してください。

${...} パラメーター (データタイムスタンプベース)

${...} パラメーターは、タスクのデータタイムスタンプを基準に時間を計算します。これらは yyyy、yy、mm、dd コンポーネントをサポートし、日、月、年の ±N 演算をサポートします。

精度：日単位のみ。時間、分、秒のコンポーネントはサポートされていません。

$[...] パラメーター (スケジューリング時間ベース)

$[...] パラメーターは、タスクのスケジューリング時間を基準に時間を計算します。これらはすべての ${...} コンポーネントに加えて hh24、hh、mi、ss をサポートし、分数演算を使用して時間と分を表現します。

精度：秒。時間または分レベルの精度が必要な場合は、これらのパラメーターを使用してください。

組み込みパラメーター

DataWorks は以下の組み込みパラメーターを提供しています。柔軟性を高めるため、可能な限りカスタム時間パラメーターを代わりに使用してください。

注意事項

• Shell ノード：Shell ノードのスケジューリングパラメーターは、$N という異なるフォーマットを使用します。N は 1 から始まる整数です。${...} および $[...] フォーマットは適用されません。

• 定数：スケジューリングパラメーターに定数文字列を割り当てると、実行ごとに同じ値が渡されます。

• ノードコード内の `${bizdate}`：ノードコード内の変数 ${bizdate} には、特別な組み込みの意味はありません。これはカスタム変数名です。${Variable} フォーマットで定義し、[スケジューリングパラメーター] セクションでマッピングした変数はすべて同じように機能します。

• 夏時間：DataWorks は、タスクのスケジューリングに影響を与えることなく夏時間の移行を処理します。タスクが夏時間を採用しているリージョンで実行される場合は、「夏時間の切り替えがタスクの実行に与える影響」をご参照ください。

付録：サポートされている組み込みスケジューリングパラメーター

以下の組み込みパラメーターはノードコードで利用可能であり、スケジューリング構成で参照できます。