すべてのプロダクト
Search
ドキュメントセンター

SchedulerX:JobContext パラメーター

最終更新日:Aug 08, 2026

JobContext オブジェクトは、現在実行中のジョブに関するランタイム情報を提供します。これには、識別子、スケジューリング時刻、リトライ状態、シャーディングの詳細、および上流のワークフローのデータが含まれます。

基本的な使用方法

ジョブハンドラ内で getter メソッドを通じて JobContext パラメーターにアクセスします。

public class SampleJobProcessor extends JavaProcessor {
    @Override
    public ProcessResult process(JobContext context) throws Exception {
        // ジョブおよびインスタンス識別子
        long jobId = context.getJobId();
        long instanceId = context.getJobInstanceId();

        // スケジューリングメタデータ
        DateTime scheduledTime = context.getScheduleTime();
        DateTime dataTime = context.getDataTime();

        // SchedulerX コンソールで設定された静的パラメーター
        String params = context.getJobParameters();

        // API 呼び出し経由で渡された動的パラメーター
        String dynamicParams = context.getInstanceParameters();

        // リトライ状態
        int currentAttempt = context.getAttempt();
        int maxRetries = context.getMaxAttempt();

        System.out.println("Job " + jobId + ", instance " + instanceId
            + ", attempt " + currentAttempt + "/" + maxRetries);

        return new ProcessResult(true);
    }
}

ジョブおよびインスタンス識別子

パラメーター型説明
jobIdlongジョブ ID。
jobInstanceIdlongジョブインスタンス ID。
jobTypeStringジョブタイプ。
taskIdlong分散ジョブ内のタスク ID。ルートタスク ID は 0 です。
taskNameStringタスク名。
taskObjectタスク本文。

スケジューリング時刻

パラメーター型説明
scheduleTimeDateTimeインスタンスのスケジュール時刻。
dataTimeDateTimeインスタンス上でジョブが実行される時刻。

ジョブパラメーター

パラメーター型説明
jobParametersStringSchedulerX コンソールで設定された静的パラメーター。最大サイズ:10,000 バイト。
instanceParametersStringAPI 呼び出しによってインスタンスがトリガーされた際に渡される動的パラメーター。

リトライパラメーター

パラメーター型説明
maxAttemptintジョブインスタンスの最大リトライ回数。
attemptintジョブインスタンスの現在のリトライ回数。
taskMaxAttemptintタスクの最大リトライ回数。
taskAttemptintタスクの現在のリトライ回数。

シャーディングパラメーター

実行モード が ブロードキャスト実行 または シャード実行 に設定されている場合にのみ利用可能です。

パラメーター型説明
shardingIdLongシャード ID。ブロードキャスト実行 および シャード実行 モードで利用可能です。
shardingParameterStringシャーディングパラメーター。シャード実行 モードでのみ利用可能です。
shardingNumintシャード総数。ブロードキャスト実行 および シャード実行 モードで利用可能です。

例:

public class ShardJobProcessor extends JavaProcessor {
    @Override
    public ProcessResult process(JobContext context) throws Exception {
        Long shardId = context.getShardingId();
        int totalShards = context.getShardingNum();
        String shardParam = context.getShardingParameter();

        System.out.println("Processing shard " + shardId + " of " + totalShards);

        return new ProcessResult(true);
    }
}

ワークフローパラメーター

ジョブがワークフローの一部として実行される場合に利用可能です。

パラメーター型説明
workflowIdLongワークフロー ID。
wfInstanceIdlongワークフローインスタンス ID。
upstreamDataList<JobInstanceData>ワークフロー内の上流ジョブインスタンスからのデータ。ワークフローには複数の上流インスタンスが存在する可能性があるため、このパラメーターはリストを返します。
workflowParametersStringワークフローパラメーター。クライアントバージョン 1.14.2 以降が必要です。