

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# CHUNK[INT] タスクパラメータリファレンス
<a name="build-job-bundle-chunking-reference"></a>

`CHUNK[INT]` タスクパラメータタイプは、Deadline Cloud が個々の値としてではなくチャンクとして処理する整数タスクパラメータを定義します。チャンクタスクパラメータの構造は次のとおりです。

```
taskParameterDefinitions:
  - name: {{identifier}}
    type: CHUNK[INT]
    range: {{integer range expression}}
    chunks:
      defaultTaskCount: {{integer}}
      rangeConstraint: CONTIGUOUS | NONCONTIGUOUS
      targetRuntimeSeconds: {{integer}}
```

次の表に各フィールドの説明を示します。


| フィールド | 必要 | 説明 | 
| --- | --- | --- | 
| range | はい | 整数のリスト、または "1-100"や などの整数範囲式として処理する整数値のフルセット"1,3,7-20:2"。などのジョブパラメータリファレンスを受け入れます"{{Param.Frames}}"。 | 
| chunks.defaultTaskCount | はい | 1 つのチャンクに結合する値の数。最大値は 150 です。などのジョブパラメータリファレンスを受け入れます"{{Param.ChunkSize}}"。 | 
| chunks.rangeConstraint | はい | 各チャンクのシェイプ。ではCONTIGUOUS、すべてのチャンクは などの連続した範囲です1-10。ではNONCONTIGUOUS、チャンクは などの任意のセットにすることができます1,3,7-10。 | 
| chunks.targetRuntimeSeconds | いいえ | 各チャンクのターゲットランタイムを秒単位で表します。設定すると、Deadline Cloud は完了したチャンクの観測ランタイムに基づいてチャンクサイズをターゲットに合わせて調整します。設定しない場合、すべてのチャンクはdefaultTaskCount値を使用します。 | 

`CHUNK[INT]` タイプには次の制約があります。
+ ジョブテンプレートは `TASK_CHUNKING`にリストする必要があります`extensions`。拡張機能がない場合、ジョブの作成は エラーで失敗します `The CHUNK[INT] task parameter requires the TASK_CHUNKING extension.`
+ ステップのパラメータスペースには、最大 1 つの`CHUNK[INT]`パラメータを含めることができます。チャンクが実行されると、他のすべてのタスクパラメータは単一の値を受け取り、チャンクされたパラメータは一連の値を受け取ります。

ステップのスクリプトでは、チャンクされたパラメータの`{{Task.Param.{{name}}}}`変数は整数範囲式文字列に拡張されます。では`rangeConstraint: CONTIGUOUS`、式は常に `1-1`や などの`{{start}}-{{end}}`形式になります`11-20`。では`rangeConstraint: NONCONTIGUOUS`、式は などの任意の整数範囲式にすることができます`1-3,5,7-20:2`。

詳細については、以下のリソースを参照してください。
+ [RFC 0001: タスクチャンキング](https://github.com/OpenJobDescription/openjd-specifications/blob/mainline/rfcs/0001-task-chunking.md) – GitHub の Open Job Description リポジトリにある 拡張機能の完全な仕様。
+ [ジョブテンプレートにタスクチャンキングを追加する](build-job-bundle-chunking-add.md) – チャンキングを使用するようにジョブテンプレートを変換します。