

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Referência do parâmetro de tarefa CHUNK [INT]
<a name="build-job-bundle-chunking-reference"></a>

O tipo de parâmetro de `CHUNK[INT]` tarefa define um parâmetro de tarefa inteiro que o Deadline Cloud processa como blocos em vez de valores individuais. Um parâmetro de tarefa fragmentado tem a seguinte estrutura:

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

A tabela a seguir descreve cada campo.


| Campo | Obrigatório | Descrição | 
| --- | --- | --- | 
| range | Sim | O conjunto completo de valores inteiros a serem processados, como uma lista de números inteiros ou uma expressão de intervalo de números inteiros, como ou. "1-100" "1,3,7-20:2" Aceita uma referência de parâmetro de trabalho, como"{{Param.Frames}}". | 
| chunks.defaultTaskCount | Sim | O número de valores a serem combinados em um único bloco. O valor máximo é 150. Aceita uma referência de parâmetro de trabalho, como"{{Param.ChunkSize}}". | 
| chunks.rangeConstraint | Sim | A forma de cada pedaço. ComCONTIGUOUS, cada pedaço é um intervalo consecutivo, como1-10. ComNONCONTIGUOUS, um pedaço pode ser um conjunto arbitrário, como. 1,3,7-10 | 
| chunks.targetRuntimeSeconds | Não | O tempo de execução desejado para cada bloco, em segundos. Quando definido, o Deadline Cloud ajusta os tamanhos dos blocos em relação à meta com base nos tempos de execução observados dos blocos concluídos. Quando não está definido, cada bloco usa defaultTaskCount valores. | 

O `CHUNK[INT]` tipo tem as seguintes restrições:
+ O modelo de trabalho deve ser `TASK_CHUNKING` listado em seu`extensions`. Sem a extensão, a criação do trabalho falha com o erro `The CHUNK[INT] task parameter requires the TASK_CHUNKING extension.`
+ O espaço de parâmetros de uma etapa pode conter no máximo um `CHUNK[INT]` parâmetro. Quando um fragmento é executado, todos os outros parâmetros da tarefa assumem um único valor, enquanto o parâmetro fragmentado assume um conjunto de valores.

No script de uma etapa, a `{{Task.Param.{{name}}}}` variável de um parâmetro fragmentado se expande para uma string de expressão de intervalo inteiro. Com`rangeConstraint: CONTIGUOUS`, a expressão está sempre em `{{start}}-{{end}}` formato, como `1-1` ou`11-20`. Com`rangeConstraint: NONCONTIGUOUS`, a expressão pode ser qualquer expressão de intervalo inteiro, como`1-3,5,7-20:2`.

Para saber mais, consulte os seguintes recursos:
+ [RFC 0001: Task Chunking ](https://github.com/OpenJobDescription/openjd-specifications/blob/mainline/rfcs/0001-task-chunking.md) — A especificação completa da extensão no repositório Open Job Description em. GitHub
+ [Adicionar fragmentação de tarefas a um modelo de trabalho](build-job-bundle-chunking-add.md)— Converta um modelo de trabalho para usar fragmentação.