パラメーター変数機能

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

例えば、特定の月のデータを指定したい場合に target_month ： 202404 （固定の文字）と設定したり、実行時の日付を使いたい場合に today ： CURRENT_DATE （自動で計算される関数）と設定したりできますタスク内で #{target_month} や #{today} と記述することで、設定した値が自動的に反映されます。

使用方法

パラメータ変数の作成

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

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

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

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

タスク内の入力項目で #{変数名} と記述することで、設定した値を呼び出すことができます。
例えば、分析フィルターで条件値として指定する場合は #{target_month} のようにしてください。

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

項目名	入力条件	概要
変数	必須	任意の変数名を入力します（例：`target_month`）
値	必須	変数に代入する値、またはパラメーター関数を入力します関数名（例：`CURRENT_DATE`）をそのまま入力してください ※ここでは `#{}` は不要です
値をシークレットとして保存する	任意	チェックを入れると値がマスクされ、保存後は参照不可になります APIキーやパスワード等の機密情報の管理に適しています

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

パラメータ関数一覧

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

関数名	概要	例
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）

注意事項

パラメーター関数は、パラメーター変数の設定内でのみ利用することが可能です。ワークフローのタスク内で直接設定することはできません。
シークレット属性の制限事項：
一度シークレット属性を設定して保存すると、後から属性を解除（値を再表示）することはできません。
ワークフローをJSON形式でエクスポートした際、シークレット属性が設定された変数の値はマスキングされて出力されます。

実行制御・高度な設定