TROCCOのカスタム変数は、ジョブの実行方法（転送設定から直接実行・ワークフローから実行・親ワークフローから実行）と、カスタム変数の展開設定（現在時刻を基準に展開・指定日時を基準に展開・変数ごとに値を指定）の組み合わせによって、展開される値が異なります。

この記事では、実際の検証結果をもとに各パターンの展開値の差異を説明します。

検証環境

転送元Google BigQueryの転送設定を作成し、以下のSQLでカスタム変数の展開値を確認しました。

SELECT
    "$runtime$" AS runtime,
    "$queing$" AS queing,
    "$label$" AS label;

検証に使用したカスタム変数

転送設定からジョブ実行する

現在時刻を基準に展開

このとき、ジョブの実行開始時間は 2026-08-07 11:38:01 +09:00 でした。

文字列は時刻・日付と異なり展開タイミングの概念がなく、カスタム変数作成時に定義した値がそのまま使われます。

指定日時を基準に展開

このとき、ジョブの実行開始時間は 2026-08-07 11:51:50 +09:00、指定した日時は 2026-08-01 10:00:00 でした。

「実行時」を選択した場合、指定した日時は無視されジョブの開始日時が使われます。「キューイング時」を選択した場合のみ、指定した日時が展開されます。

変数ごとに値を指定

このとき、ジョブの実行開始時間は 2026-08-07 11:57:58 +09:00 でした。実行時・キューイング時ともに 2026-08-01 10:00:00、文字列には resource_1 を指定しました。

「変数ごとに値を指定」では実行時・キューイング時どちらを選択しても、指定した値で展開されます。

ワークフローからジョブ実行する

ワークフロー側でカスタム変数を指定した場合、ワークフロー側の設定が転送設定側の設定を上書きします。検証では $label$ にループ実行（workflow_1 / workflow_2 / workflow_3）を設定しました。

現在時刻を基準に展開

ワークフローのトリガー時刻は 2026-08-07 12:09:00 でした。

転送設定から設定した場合と異なり、ワークフロー内に複数のリソースがある場合、実行時はそれぞれのジョブ開始日時が基準になります。キューイング時はワークフローのトリガー時刻が基準となります。

指定日時を基準に展開

ジョブの実行開始時間は 2026-08-07 13:11:59 +09:00、指定した日時は 2026-08-01 11:00:00 でした。

変数ごとに値を指定

実行開始時間は 2026-08-07 13:31:23 +09:00 でした。ワークフロー側で実行時・キューイング時ともに 2026-08-01 12:00:00、文字列には resource_diff を指定しました。

ワークフロー側でループ実行が設定されている文字列のカスタム変数に対して「変数ごとに値を指定」で値を指定しても、ループ実行の値が優先されます。

親ワークフローからジョブ実行する

子ワークフローをタスクとして持つ親ワークフローから実行した場合の展開結果です。検証では子ワークフローにて $label$ にループ実行（workflow_1 / workflow_2 / workflow_3）を設定しました。

現在時刻を基準に展開

親ワークフローのトリガー時刻は 2026-08-07 13:45:32 でした。

ワークフローからジョブ実行する場合と同様に、実行時はそれぞれのジョブ開始日時が基準になります。キューイング時は親ワークフローのトリガー時刻が基準となります。

指定日時を基準に展開

親ワークフローの実行開始時間は 2026-08-07 13:50:31 +09:00、指定した日時は 2026-08-01 13:00:00 でした。

変数ごとに値を指定

親ワークフローの実行開始時間は 2026-08-07 15:13:16 +09:00 でした。実行時・キューイング時ともに 2026-08-01 14:00:00、文字列には resource_diff を指定しました。

ループ実行が設定されている文字列のカスタム変数に対して「変数ごとに値を指定」で値を指定しても、ループ実行の値が優先されます。

子ワークフローにループ実行を設定している場合の注意

子ワークフローで文字列のカスタム変数にループ実行を設定している場合、親ワークフローからの変数指定は以下の挙動になります。

親ワークフローと子ワークフローの両方で同じ文字列のカスタム変数にループを設定すると、実行回数が掛け算になります。意図せず大量のジョブが実行される可能性があるため、親子両方でループを設定する際は実行回数に注意してください。

親から子の変数を上書きしたい場合は、子ワークフローのループ実行設定を解除した上で親から値を指定してください。

まとめ

• 時刻・日付（実行時）は、展開設定に「現在時刻を基準」「指定日時を基準」どちらを選択しても、常にそのジョブの開始日時が展開される
• 時刻・日付（キューイング時）のキューイング時刻の基準は実行方法によって異なる
  • 転送設定から実行：ジョブ実行をトリガーした時刻
  • ワークフローから実行：ワークフローのトリガー時刻
  • 親ワークフローから実行：親ワークフローのトリガー時刻
• 「変数ごとに値を指定」では、実行時・キューイング時どちらを選択しても指定した値で展開される
• ワークフロー側でカスタム変数の展開値を設定した場合、転送設定側の設定は上書きされる
• ワークフローでループ実行が設定されている文字列のカスタム変数は、「変数ごとに値を指定」で値を指定してもループ設定の値が優先される