パラメーター変数機能

パラメーター変数機能は、あらかじめ任意の値や関数を変数として定義し、タスク内でその変数を使用することで、実行時に値を動的に設定できる機能です。

例えば、ワークフロー実行時の現在日時をタスク内で使用したい場合、パラメーター変数として [現在日時 = CURRENT_DATETIME] を設定しておきます。タスク内で #{現在日時} と記述することで、実行時の日時を自動的に取得・設定することが可能になります。

使用方法

パラメータ変数の作成

1.画面右上の歯車マークをクリックします

2.追加をクリックします

3.任意の変数名と値（または関数）を入力し、設定ボタンをクリックします

作成したパラメーター変数の指定

タスク内の入力項目で #{変数名} と記述することで、設定した値を呼び出すことができます。
例えば、転送先(シンク)Google BigQueryでテーブル名を指定する場合は #{table} のようにしてください。

パラメータ変数の設定仕様

項目名	入力条件	概要
変数	必須	任意の変数名を入力します（例：`現在日付`）
値	必須	変数に代入する値、またはパラメーター関数を入力します ※ここでは `#{}` は不要です。関数名（例：`CURRENT_DATE`）をそのまま入力してください

ワークフローを実行すると、タスク内に記述された #{変数名} は、あらかじめ設定した「値」や「関数の実行結果」に自動で置き換わります。

パラメータ関数一覧

利用できるパラメーター関数は以下になり、よく使われるパラメーター変数についてはこちらをご確認ください。

関数名	概要	例
CURRENT_DATE	ワークフロー実行時の日付を返します。引数でフォーマット指定可能です。（引数なしの場合、タイムゾーンAsia/Tokyoのyyyy-MM-dd）	`CURRENT_DATE` `CURRENT_DATE()` `CURRENT_DATE(yyMMdd)`
CURRENT_TIME	ワークフロー実行時の時刻を返します。引数でフォーマット指定可能です。（引数なしの場合、タイムゾーンAsia/TokyoのHH:mm:ss.SSS000）	`CURRENT_TIME` `CURRENT_TIME()` `CURRENT_TIME(HHmmss)`
CURRENT_DATETIME	ワークフロー実行時の日時を返します。引数でフォーマット指定可能です。（引数なしの場合、タイムゾーンAsia/Tokyoのyyyy-MM-dd HH:mm:ss.SSS000）	`CURRENT_DATETIME` `CURRENT_DATETIME()` `CURRENT_DATETIME(SSS)`
CURRENT_TIMESTAMP	ワークフロー実行時のGMTとの時差+09が付与された日時を返します。引数でフォーマット指定可能です。（引数なしの場合、タイムゾーンAsia/Tokyoのyyyy-MM-dd HH:mm:ss.SSS000X）	`CURRENT_TIMESTAMP` `CURRENT_TIMESTAMP()` `CURRENT_TIMESTAMP(yyyy)`
WORKFLOW_LAST_STARTED_AT	ワークフロー実行が成功したものの前回実行開始時のGMTとの時差+09が付与された日時を返します。引数でフォーマット指定可能です。（引数なしの場合、タイムゾーンAsia/Tokyoのyyyy-MM-dd HH:mm:ss.SSS000X）	`WORKFLOW_LAST_STARTED_AT` `WORKFLOW_LAST_STARTED_AT()` `WORKFLOW_LAST_STARTED_AT(yyyy/MM/dd HH:mm:ss)` `DATETIME_SUB(WORKFLOW_LAST_STARTED_AT(yyyy-MM-dd'T'HH:mm:ss'Z'), interval 9 hour)` ⚠️ 値が取得できないケース：前回実行履歴がない / プレビュー実行時 / ワークフローの重複実行時プレビュー時にエラーになるケース：４番目の例のように関数をネスト（入れ子）で定義している場合（※実行自体は正常に動作します）
WORKFLOW_LAST_ENDED_AT	ワークフロー実行が成功したものの前回実行終了時のGMTとの時差+09が付与された日時を返します。引数でフォーマット指定可能です。（引数なしの場合、タイムゾーンAsia/Tokyoのyyyy-MM-dd HH:mm:ss.SSS000X）	`WORKFLOW_LAST_ENDED_AT` `WORKFLOW_LAST_ENDED_AT()` `WORKFLOW_LAST_ENDED_AT(yyyy/MM/dd HH:mm:ss)` `DATETIME_SUB(WORKFLOW_LAST_ENDED_AT(yyyy-MM-dd'T'HH:mm:ss'Z'), interval 9 hour)` ⚠️ 値が取得できないケース：前回実行履歴がない / プレビュー実行時 / ワークフローの重複実行時プレビュー時にエラーになるケース：４番目の例のように関数をネスト（入れ子）で定義している場合（※実行自体は正常に動作します）
DATETIME_ADD	第一引数に指定された日付/時刻に第二引数で指定された期間を足します。期間の種別： microsecond, millisecond, second, minute, hour, day, week, month, year	`DATETIME_ADD(CURRENT_DATE, interval 1 hour)` `DATETIME_ADD(CURRENT_DATE(yyyy/MM/dd), interval 1 day)`
DATETIME_SUB	第一引数に指定された日付/時刻に第二引数で指定された期間を引きます。期間の種別： microsecond, millisecond, second, minute, hour, day, week, month, year	`DATETIME_SUB(CURRENT_DATE, interval 1 hour)` `DATETIME_SUB(CURRENT_DATE(yyyy/MM/dd), interval 1 month)`
WITH_DAY_OF_MONTH	第一引数に渡された日付/時刻をその月の指定された日に変更します。	`WITH_DAY_OF_MONTH(CURRENT_DATE, 1)`
RAND	0~1のランダムなfloat数値を返します。引数は取りません。	`RAND` `RAND()`
GENERATE_UUID	UUIDを返します。引数は取りません。	`GENERATE_UUID` `GENERATE_UUID()`
UNIX_SECONDS	ワークフロー実行時の日付と時刻を1970-01-01 00:00:00 UTC からの秒数に変換して返します。	`UNIX_SECONDS` （実行結果例: 1767693793）
UNIX_MILLIS	ワークフロー実行時の日付と時刻を1970-01-01 00:00:00 UTC からのミリ秒数に変換して返します。	`UNIX_MILLIS` （実行結果例: 1767693793397）

注意事項

パラメーター関数は、パラメーター変数の設定内でのみ利用することが可能です。ワークフローのタスク内で直接設定することはできません。

ワークフロー設定