O que o Merge Faz
O nó Merge no n8n permite que você combine dados de dois ou mais ramos diferentes do seu workflow, seja mesclando registros relacionados, anexando listas, ou aguardando que múltiplas operações paralelas sejam concluídas antes de continuar.
- Combina dados de múltiplas entradas em uma única saída estruturada
- Suporta vários modos de mesclagem para diferentes casos de uso
- Essencial para workflows paralelos que precisam sincronizar resultados
- Permite enriquecer dados combinando informações de diferentes fontes
Modos de Mesclagem
1. Append
Anexa todos os itens de todas as entradas em uma única lista
- Simplesmente junta todos os itens
- Não faz correspondência ou combinação
- Útil para consolidar resultados de múltiplas fontes
2. Merge By Fields
Combina itens baseado em campos chave correspondentes
- Como um JOIN de banco de dados
- Especifica campos chave para correspondência
- Mescla campos de itens correspondentes
3. Merge By Position
Combina itens baseado em sua posição no array
- Primeiro item com primeiro item, segundo com segundo, etc.
- Útil quando ordem é significativa
- Itens devem estar em ordem correspondente
4. Wait to Finish
Aguarda todas as entradas completarem antes de continuar
- Sincroniza operações paralelas
- Passa dados da primeira entrada apenas
- Útil para garantir que tudo termine antes do próximo passo
Principais Casos de Uso
- Enriquecimento de Dados: Combinar dados de cliente de CRM com dados de vendas do banco de dados
- Consolidação de Resultados: Juntar resultados de múltiplas APIs ou fontes de dados
- Sincronização Paralela: Aguardar múltiplas operações paralelas completarem antes de continuar
- Combinação de Dados Relacionados: Juntar tabelas relacionadas como em JOIN de SQL
- Agregação Multi-fonte: Combinar dados de diferentes sistemas para relatórios unificados
Como Configurar
Configuração Básica
- Inserir o Nó: Adicione onde dois ou mais ramos de workflow se encontram
- Conectar Entradas: Conecte múltiplos nós ao Merge (Input 1, Input 2, etc.)
- Escolher Modo: Selecione o modo de mesclagem apropriado para seu caso de uso
- Configurar Campos: Para Merge By Fields, especifique os campos chave
- Testar: Execute com dados de teste para verificar resultado da mesclagem
Comparação de Modos
| Modo | Quando Usar | Exemplo |
|---|---|---|
| Append | Combinar listas sem relação | Juntar leads de 3 fontes diferentes |
| Merge By Fields | Combinar dados relacionados | Juntar dados de cliente com pedidos por customer_id |
| Merge By Position | Dados em ordem correspondente | Combinar nomes com emails na mesma ordem |
| Wait to Finish | Sincronizar operações paralelas | Aguardar 3 uploads de arquivo completarem |
Exemplos Práticos
Exemplo 1: Enriquecimento de Dados de Cliente
Cenário: Combinar dados básicos de clientes com histórico de compras
- Input 1: Buscar clientes do CRM → [{id: 1, name: "João", email: "..."}]
- Input 2: Buscar pedidos do DB → [{customer_id: 1, total: 500}]
- Merge By Fields: id = customer_id
- Resultado: [{id: 1, name: "João", email: "...", total: 500}]
Exemplo 2: Consolidação de Múltiplas APIs
Cenário: Buscar produtos de 3 fornecedores diferentes
- Input 1: API Fornecedor A → [prod1, prod2]
- Input 2: API Fornecedor B → [prod3, prod4]
- Input 3: API Fornecedor C → [prod5]
- Merge Append: Junta tudo em [prod1, prod2, prod3, prod4, prod5]
Exemplo 3: Sincronização de Uploads Paralelos
Cenário: Fazer upload de múltiplos arquivos em paralelo e aguardar todos
- Input 1: Upload arquivo 1 para S3
- Input 2: Upload arquivo 2 para S3
- Input 3: Upload arquivo 3 para S3
- Merge Wait to Finish: Aguarda todos completarem
- Próximo passo: Enviar notificação de conclusão
Melhores Práticas
- Valide Campos Chave: Ao usar Merge By Fields, garanta que campos chave existem em ambas as entradas
- Considere Performance: Merge By Fields pode ser lento com muitos itens - otimize quando possível
- Documente Lógica: Deixe claro no workflow qual modo de merge está sendo usado e por quê
- Trate Dados Ausentes: Planeje para casos onde não há correspondência (em Merge By Fields)
- Use Wait to Finish Apropriadamente: Quando precisar apenas sincronizar, não combinar dados
- Teste com Dados Reais: Sempre teste merges com volumes e variedades de dados representativos
Troubleshooting
Problemas Comuns
- Merge não encontra correspondências: Verifique se campos chave têm mesmo tipo de dados e formato
- Dados duplicados: Pode acontecer se campos chave não são únicos - considere limpeza prévia
- Ordem incorreta: Merge By Position requer ordem consistente - use Sort antes se necessário
- Timeout: Para grandes volumes, considere processar em lotes menores