メインコンテンツまでスキップ

パラメータ管理

最終更新 2026/10/05

空間パラメータの概要​

空間パラメータはパラメータ体系を構成する要素の1つで、その作用範囲はスペース全体です。つまり、そのスペース内のすべてのタスクフローやオフライン同期プランなどのモジュールで、これらの空間パラメータを使用できます。空間パラメータはプリセット空間パラメータとカスタム空間パラメータに分かれます。

プリセットパラメータ​

プリセットパラメータ説明
基準日付 ${bd}

Base date。データ集計の基準となる日付です。ワークスペースの新規作成時に日付形式とオフセットを定義する必要があります

詳しくはデータ開発スペース管理をご覧ください

基準タイムゾーン ${btz}

Base timezone。データ集計の基準となるタイムゾーンです。ワークスペースの新規作成時にタイムゾーンを定義する必要があります

詳しくはデータ開発スペース管理をご覧ください

理論的なスケジュール時間 ${st}

タスクインスタンスが理論上実行されるべき時点です。デフォルトの形式はyyyyMMddHHmmssで、ワークスペースの新規作成時に定義する必要があります

詳しくはデータ開発スペース管理をご覧ください

実行環境 ${env}実行環境に応じて、対応する環境値を使用します。取り得る値はdev、productです
本番環境データベース ${ws_prod_db}システムにプリセットされた本番環境のデータベース名で、タスクフローの開発に使用できます
開発環境データベース ${ws_dev_db}システムにプリセットされた開発環境のデータベース名で、タスクフローの開発に使用できます
IDEデータベース ${ws_ide_db}システムにプリセットされたIDEのデータベース名
スペースの基準日付とタイムゾーンの定義

空間パラメータ(カスタム)​

空間パラメータ一覧では、現在のスペースで使用可能なすべてのカスタム空間パラメータを確認できます

パラメータ管理モジュールで「+空間パラメータ」をクリックして、カスタム空間パラメータを追加することもできます。

空間パラメータの設定は次のとおりです:

フィールド説明
パラメータ名

カスタム空間パラメータの名前

  • 最大40文字で、現在のプリセットパラメータと同じ名前にすることはできません。スペース内で一意である必要があります
  • ws_で始めることはできません。${bd}、${btz}は使用できません。
  • 英字で始まり、英小文字、数字、アンダースコアを使用できます
タイプ

カスタム空間パラメータのタイプ

  • 「純粋なテキスト」と「SQL 式」の2種類があります

純粋なテキスト:プレーンテキストの値です。例:

  • num = 2
  • city = shanghai

SQL 式:式の中でプリセットパラメータを参照できます

たとえば、デフォルトの日付形式がyyyy-MM-ddのプリセットパラメータ${bd}を参照する場合、式は次のように記述できます

  • ${bd} 値:2025-02-01
  • ${bd:yyyy-MM-dd-7} 値:2025-01-23
  • ${bd:yy/MM/dd-7} 値:2025/01/23
値
  • タイプ = 「純粋なテキスト」の場合は、値をそのまま指定します
  • タイプ = 「SQL 式」の場合は、式を指定します
説明空間パラメータの説明

空間パラメータ式の記入例​

${bd}をそのまま使用した場合は、調整は一切行われず、デフォルトの値と形式で返されます

${bd}の書式設定式はDolphinScheduler(DS)の直接式と同様で、${bd:yyyy-MM-dd-1}、${bd:dd/MM/yy}などがあります。カスタム形式(同じくSimpleDateFormatを使用)の後に直接"+/-"と数字を付けることができ、単位は日です。

形式が${bd:yyyy-MM-dd}の場合を例にします:

  • N週間後:${bd:yyyy-MM-dd+N*week}
  • N週間前:${bd:yyyy-MM-dd-N*week}
  • N日後:${bd:yyyy-MM-dd+N}、${bd:yyyy-MM-dd+N*day}
  • N日前:${bd:yyyy-MM-dd-N}、${bd:yyyy-MM-dd-N*day}
  • N時間後:${bd:yyyy-MM-dd HH:mm:ss+N*hour}
  • N時間前:${bd:yyyy-MM-dd HH:mm:ss-N*hour}
  • N分後:${bd:yyyy-MM-dd HH:mm:ss+N*minute}
  • N分前:${bd:yyyy-MM-dd HH:mm:ss-N*minute}

年と月のオフセットには、次の方法を使用できます:

  • Nか月後:${bd:yyyy-MM-dd+N*month}
  • Nか月前:${bd:yyyy-MM-dd-N*month}
  • N年後:${bd:yyyy-MM-dd+N*year}
  • N年前:${bd:yyyy-MM-dd-N*year}
このページは役に立ちましたか?