本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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 | 是 | 要合併為單一區塊的值數目。最大值為 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.`
+ 步驟的參數空間最多可包含一個`CHUNK[INT]`參數。當區塊執行時，所有其他任務參數會接受單一值，而區塊參數則會接受一組值。

在步驟的指令碼中，區塊化參數的`{{Task.Param.{{name}}}}`變數會展開為整數範圍表達式字串。使用 `rangeConstraint: CONTIGUOUS`時，表達式一律為 `{{start}}-{{end}}` 格式，例如 `1-1`或 `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 上開放任務描述儲存庫中延伸模組的完整規格。
+ [將任務區塊新增至任務範本](build-job-bundle-chunking-add.md) – 將任務範本轉換為使用區塊。