本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 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) — 上的 Open Job Description 存储库中扩展的完整规范。 GitHub
+ [向作业模板添加任务分块](build-job-bundle-chunking-add.md)— 将作业模板转换为使用分块。