O que é Batch?

O que é um batch

Batch é um grupo de itens tratado como uma unidade de processamento. Uma automação pode dividir uma lista de inscrições em lotes para enviar campos a uma API, gerar arquivos ou controlar quantos itens entram em cada repetição.

O agrupamento define o tamanho de cada parte do trabalho, mas não determina como os itens serão executados internamente. Um lote de vinte inscrições pode ser processado item por item ou enviado de uma vez, dependendo do componente e do serviço de destino.

Agrupar no workflow e enviar em lote são ações diferentes

Dividir a entrada em batches não reduz automaticamente o número de chamadas. Se o Node seguinte faz uma chamada para cada inscrição, uma lista de cem itens ainda pode produzir cem chamadas, mesmo organizada em grupos de dez.

Uma API que aceita vários itens por requisição pode reduzir esse total. Nesse caso, o workflow precisa montar o corpo de acordo com o contrato do endpoint, pois agrupar os itens visualmente não transforma uma API de cadastro individual em uma API de cadastro em lote.

Quantidade de itens e tamanho em bytes

O limite do serviço pode considerar tanto o número de itens quanto o tamanho total da requisição. Dez registros pequenos e dez arquivos extensos representam quantidades iguais de itens, mas podem exigir memória e tráfego muito diferentes.

A duração também influencia a escolha. Um lote maior pode demorar mais para produzir uma resposta, ultrapassar um timeout ou tornar a recuperação mais trabalhosa quando o destino aceita apenas parte do conteúdo.

O resultado pode variar dentro do lote

Algumas APIs informam sucesso ou falha para cada item, enquanto outras aceitam ou recusam todo o grupo. A atomicidade precisa ser garantida pelo serviço ou pela implementação, e não pode ser inferida da palavra batch.

O envio em lote do Amazon SQS é um exemplo de contrato que pode devolver itens aceitos e recusados na mesma resposta, inclusive com status HTTP de sucesso. A integração precisa ler os resultados individuais para saber o que ainda exige tratamento.

Se oito inscrições forem aceitas e duas recusadas, repetir as dez pode duplicar as oito primeiras. A recuperação deve usar os identificadores e o comportamento de repetição documentado, preservando os resultados já concluídos.

Lotes não controlam sozinhos a frequência

Processar grupos pequenos continuamente ainda pode ultrapassar o rate limit da API. O controle precisa considerar as pausas entre chamadas e também outras execuções que usam a mesma cota.

No n8n, o Loop Over Items permite trabalhar com grupos, mas o fluxo ao redor dele define a chamada e a espera. O tamanho do batch e a concorrência devem ser conferidos separadamente.

Como testar o processamento em lote

Use uma lista que não seja divisível pelo tamanho escolhido e inclua um item que será recusado no ambiente de teste. Confira se o último grupo foi processado e se o relatório distingue cada sucesso de cada falha.

Depois, repita apenas o trabalho que o contrato permite recuperar e consulte o destino. A conferência deve mostrar quais itens existem, quais continuam pendentes e se algum foi criado novamente durante a recuperação.

Aplicação na formação

n8n Experts

Dividir uma entrada em lotes permite ajustar o volume processado por etapa à capacidade do destino.

Conhecer a formação →