n8n의 Merge 노드

n8n의 Merge 노드

n8n의 Merge 노드

n8n 머지노드(Merge Node) 완벽 가이드

n8n에서 머지노드는 여러 데이터 스트림을 하나로 합칠 때 사용하는 핵심 노드입니다. 워크플로우에서 서로 다른 소스의 데이터를 조합하거나, 조건 분기 후 데이터를 다시 합칠 때 매우 유용합니다[1][2].

머지노드 주요 기능

• 여러 입력 스트림의 데이터를 다양한 방식으로 병합
• 데이터 구조와 목적에 따라 다양한 병합 모드 지원
• SQL 쿼리로 커스텀 병합 가능(n8n 1.49.0 이상)

머지노드 모드별 동작 방식

모드	설명
Append	모든 입력의 데이터를 순서대로 이어붙임
Combine	두 입력 데이터를 다양한 기준(필드 값, 순서, 모든 조합)으로 병합
SQL Query	SQL 쿼리로 입력 데이터를 직접 병합(n8n 1.49.0 이상)
Choose Branch	입력 중 하나만 선택해서 그대로 출력

Combine 모드 세부 옵션

• Matching Fields: 지정한 필드 값이 같은 아이템끼리 병합(예: language 필드로 각 사람에게 맞는 인사말 붙이기)
• Position: 입력 1의 0번째와 입력 2의 0번째처럼 인덱스 순서대로 병합
• All Possible Combinations: 모든 입력 조합을 만들어 병합(카티션 곱)
• Clash Handling: 같은 이름의 필드가 겹칠 때 처리 방식 지정(입력 우선순위, 필드명에 입력 번호 추가 등)
• Deep/Shallow Merge: 중첩된 객체까지 병합할지(top-level만 병합할지) 선택

---

예시: 코드 노드로 샘플 데이터 생성 후 병합하기

1. Code 노드 1:

   return [
     { json: { name: 'Stefan', language: 'de' } },
     { json: { name: 'Jim', language: 'en' } },
     { json: { name: 'Hans', language: 'de' } }
   ];

2. Code 노드 2:

   return [
     { json: { greeting: 'Hello', language: 'en' } },
     { json: { greeting: 'Hallo', language: 'de' } }
   ];

3. 두 코드 노드를 각각 Merge 노드의 Input 1, Input 2에 연결

4. 머지 모드별 결과 예시

   • Append

name	language	greeting
Stefan	de
Jim	en
Hans	de
	en	Hello
	de	Hallo

• Combine > Matching Fields (language)

name	language	greeting
Stefan	de	Hallo
Jim	en	Hello
Hans	de	Hallo

• Combine > Position

name	language	greeting
Stefan	de	Hello
Jim	en	Hallo

실전 활용 팁

• 입력 데이터 개수가 다를 경우, Input 1의 아이템 수만큼만 병합이 진행됩니다.
• 필드명이 충돌할 때는 옵션에서 우선순위나 필드명 변경 방식을 지정할 수 있습니다.
• 복잡한 데이터 병합이 필요하면 SQL Query 모드를 활용해보세요.

카테고리 다른 글