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。

如需詳細資訊，請參閱下列資源：