Batch

Definição

Batch é um grupo de itens tratado em conjunto ou como uma unidade de trabalho. O tamanho do grupo define quantos itens cada ciclo de processamento recebe, e o tratamento dado ao lote define o que acontece com cada um deles. Agrupar itens reduz o número de chamadas ao destino e organiza o volume da entrada em etapas previsíveis.

Tamanho e destino

A divisão em lotes se relaciona ao volume da entrada e à capacidade do destino. Um serviço com limite de chamadas aceita melhor grupos menores, enquanto um destino robusto pode receber um lote maior. O tamanho escolhido precisa caber no intervalo permitido pelo serviço, porque um lote grande demais pode ser recusado inteiro.

O que o batch não garante

O batch não significa necessariamente processamento paralelo, e não garante que todas as ações do lote sejam atômicas. Cada item pode ter resultado e falha próprios, e o acompanhamento precisa considerar essa separação. Um registro que falha não derruba os demais, e o fluxo precisa saber qual item do lote foi recusado para repetir apenas ele.

Falha por item e verificação

A falha comum é tratar o lote como um bloco único: quando um item é recusado, o fluxo repete o grupo inteiro e reprocessa itens que já foram aceitos. Para verificar, confira o resultado de cada item dentro do lote no registro da execução. Quando apenas um registro apresenta erro e os demais confirmam sucesso, o fluxo deve repetir somente o item recusado, e a observação do status por item mostra se o retry está isolando a falha.

Aplicação na formação

n8n Experts

Na formação n8n Experts, dividir uma entrada em lotes ajuda a adequar o volume de trabalho à capacidade do destino.

Conhecer a formação →