Merge (병합) 노드 가이드
최대 세 개의 입력 데이터를 하나로 병합하는 노드입니다. 순서대로 추가, 인덱스별 병합, 키 기반 병합, 교차 조인 등 다양한 병합 방식을 제공합니다.
주요 기능
최대 3개의 입력(Input 1, Input 2, Input 3) 지원
4가지 병합 모드: 순서대로 추가, 인덱스별 병합, 키로 병합, 교차 조인
속성 충돌 시 우선순위 설정
필드 접두사 추가로 충돌 방지
불일치 아이템 처리 옵션
입력 구조
입력 | 설명 |
|---|---|
Input 1 | 첫 번째 데이터 입력 |
Input 2 | 두 번째 데이터 입력 |
Input 3 | 세 번째 데이터 입력 (선택) |
설정 항목
병합 모드
모드 | 설명 |
|---|---|
순서대로 추가 (Append) | Input 1의 모든 아이템 뒤에 Input 2, Input 3의 아이템을 차례로 추가합니다 |
인덱스별 병합 (Merge By Index) | 같은 인덱스(순서)의 아이템을 하나의 객체로 병합합니다 |
키로 병합 (Merge By Key) | 지정한 키 필드의 값이 같은 아이템끼리 병합합니다 |
교차 조인 (Cross Join) | 모든 입력의 아이템을 서로 조합하여 카르테시안 곱을 생성합니다 |
인덱스별 병합 옵션
불일치 처리
옵션 | 설명 |
|---|---|
모두 포함 | 모든 아이템을 포함합니다. 짝이 없는 아이템도 출력됩니다 |
짝이 있는 것만 | 모든 입력에 존재하는 인덱스의 아이템만 포함합니다 |
Input 1 우선 | Input 1의 모든 아이템을 포함합니다 |
Input 2 우선 | Input 2의 모든 아이템을 포함합니다 |
속성 충돌 처리
옵션 | 설명 |
|---|---|
Input 1 우선 | 같은 키가 있으면 Input 1의 값을 사용합니다 |
Input 2 우선 | 같은 키가 있으면 Input 2의 값을 사용합니다 (기본값) |
병합 | 두 값을 모두 유지합니다. 객체는 깊은 병합, 배열은 합칩니다 |
키로 병합 옵션
필드 | 설명 | 기본값 |
|---|---|---|
Input 1 키 필드 | Input 1에서 병합 기준으로 사용할 필드명 |
|
Input 2 키 필드 | Input 2에서 병합 기준으로 사용할 필드명 |
|
Input 3 키 필드 | Input 3에서 병합 기준으로 사용할 필드명 |
|
추가 옵션
옵션 | 설명 | 기본값 |
|---|---|---|
필드 접두사 추가 | 충돌 방지를 위해 각 입력의 필드에 접두사를 추가합니다 |
|
Input 1 접두사 | Input 1 필드에 추가할 접두사 |
|
Input 2 접두사 | Input 2 필드에 추가할 접두사 |
|
Input 3 접두사 | Input 3 필드에 추가할 접두사 |
|
사용 예시
순서대로 추가 (Append)
두 API의 결과를 하나의 목록으로 합칩니다.
Input 1: [{ "name": "A" }, { "name": "B" }]Input 2: [{ "name": "C" }, { "name": "D" }]
결과: [{ "name": "A" }, { "name": "B" }, { "name": "C" }, { "name": "D" }]
인덱스별 병합 (Merge By Index)
사용자 기본 정보와 프로필 정보를 순서대로 합칩니다.
Input 1: [{ "id": 1, "name": "홍길동" }]Input 2: [{ "email": "hong@test.com", "age": 30 }]
결과: [{ "id": 1, "name": "홍길동", "email": "hong@test.com", "age": 30 }]
키로 병합 (Merge By Key)
서로 다른 출처의 데이터를 공통 키(id)로 연결합니다.
Input 1: [{ "id": "A1", "name": "상품A" }]Input 2: [{ "id": "A1", "price": 10000 }]키 필드: id
결과: [{ "id": "A1", "name": "상품A", "price": 10000 }]
접두사로 충돌 방지
두 입력에 같은 이름의 필드가 있을 때 접두사를 붙여 구분합니다.
Input 1: [{ "name": "원본" }]Input 2: [{ "name": "번역본" }]접두사 옵션 활성화
결과: [{ "input1_name": "원본", "input2_name": "번역본" }]
참고 사항
교차 조인(Cross Join)의 결과 수는
Input 1 수 x Input 2 수 x Input 3 수입니다. 최대 100,000개까지 허용되며, 초과 시 오류가 발생합니다.키로 병합 시 키 값은 문자열로 변환하여 비교합니다.
깊은 병합 모드에서 배열은 합쳐지며, 합친 배열이 10,000개를 초과하면 나중 값으로 대체됩니다.
Input 3는 선택 사항이며, 연결하지 않아도 됩니다.