n8n Merge 노드 — Append · Combine · SQL Join

워크플로가 복잡해지면 자연스럽게 두 갈래 데이터가 생긴다. "Sheets 의 사용자 목록 + Postgres 의 결제 정보를 합쳐서 Slack 으로 보내기" 같은 흔한 시나리오. 이때 쓰는 노드가 Merge — 그런데 4가지 모드가 있어서 처음엔 어느 걸 골라야 할지 헷갈린다.

15편에서는 4 모드의 차이를 SQL Join 과 1:1 매핑하고, 매칭 키를 잘못 잡았을 때 일어나는 사고를 짚는다. 실전에서 두 스트림 합치는 패턴이 손에 잡힌다.

1. Merge 4 모드 — SQL Join 과 1:1 대응

Merge 노드 첫 옵션 Mode 가 모든 걸 결정한다. 4개 중 하나, 그리고 Combine 모드 안에 또 5개 하위 옵션.

2. 매칭 키 (Fields to Match) — 함정 3개

Combine 모드를 고르면 "Fields to Match" 필드가 나온다. 어떤 필드로 양쪽 데이터를 매칭할지 지정. 여기가 가장 자주 실수하는 자리.

함정 1 — 대소문자·공백 불일치

한쪽은 email: "[email protected] ", 다른 쪽은 email: "[email protected]" 이면 매칭 안 됨. n8n Combine 은 strict equality. 매칭 직전에 Set 노드로 정규화:

={{ ($json.email || '').trim().toLowerCase() }}

이 작업을 Merge 노드 직전에 항상 끼는 게 안전. 14편 Loop 처럼 다량 처리할수록 누락 발견이 늦어진다.

함정 2 — 중복 키로 N×M 폭발

Input 1 에 같은 키가 3개, Input 2 에 같은 키가 5개면 결과는 15 row. 의도였으면 OK, 아니면 데이터가 부풀어오른다. 매칭 키는 양쪽 모두 UNIQUE 인 컬럼이 원칙. 안 그러면 Merge 직전에 Remove Duplicates 노드로 미리 정리.

함정 3 — 타입 불일치 (string vs number)

한쪽은 user_id 가 문자열 "123", 다른 쪽은 숫자 123 이면 매칭 안 됨. JSON 에서 흔히 발생 — Sheets 는 모두 문자열, Postgres 는 숫자. Set 노드로 한쪽을 변환:

={{ Number($json.user_id) }}

3. 실전 시나리오 — Sheets + Postgres 합치기

예시 워크플로: "Google Sheets 의 가입 사용자 목록 (이메일·이름) + Postgres 의 결제 이력 (이메일·총결제액) → 결제액 별로 등급 분류 후 Slack 알림".

1. Schedule (매일 자정) → 트리거
2. Google Sheets Read → user_list 시트 전체 가져오기 (Input 1)
3. Postgres Execute Query → SELECT email, SUM(amount) AS total FROM payments GROUP BY email (Input 2)
4. Set (Input 1) → email 정규화: ={{ ($json.email||'').trim().toLowerCase() }}
5. Set (Input 2) → 동일하게 email 정규화 + total 을 Number 로 변환
6. Merge → Mode: Combine / Output Type: Enrich Input 1 / Fields to Match: email
7. Switch → total 별 분기 (≥100만 VIP, ≥10만 일반, 미만 신규)
8. Slack → 각 분기마다 다른 채널 알림

핵심은 노드 4·5번 — Merge 직전에 항상 정규화 Set 을 끼는 패턴. 양쪽 데이터 소스의 형식 차이가 누락의 99%다. 18편 Postgres 의 RETURNING 패턴과 합치면 "방금 들어온 신규 결제만 합쳐서 알림" 같은 실시간 처리도 가능.

4. SQL Query 모드 — 언제 필수인가

위 8가지 옵션으로도 안 되는 케이스가 있다. 3개 이상 입력을 한 번에 join 하거나, 집계 (GROUP BY · 윈도우 함수) 가 필요한 경우. 이때 SQL Query 모드.

입력 N개가 input1·input2·input3 가상 테이블로 들어온다 (n8n 내부에 SQLite 가 돌아감). 예 — 사용자 + 결제 + 환불 3 소스를 합쳐 순이익 계산:

SELECT u.email, u.name, COALESCE(p.total,0) - COALESCE(r.total,0) AS net
FROM input1 AS u
LEFT JOIN input2 AS p ON p.email = u.email
LEFT JOIN input3 AS r ON r.email = u.email;

장점 — 익숙한 SQL 문법. 단점 — 큰 데이터는 SQLite 메모리 한계 (수십만 row 부터 느려짐). 그 규모면 18편 Postgres 직접 쿼리가 답.