View a markdown version of this page

CHUNK [INT] 任务参数参考 - 截止日期云

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

CHUNK [INT] 任务参数参考

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。

有关更多信息，请参阅以下资源：