데이터 조인

데이터 조인 스킬은 두 데이터셋을 키 컬럼 기준으로 병합합니다. Excel의 VLOOKUP, SQL의 JOIN과 유사한 기능을 제공합니다.

---

설정 방법

1. 스킬 노드 추가 및 선택

스킬 노드를 추가하고 우측 패널에서 데이터 조인을 선택합니다.

2. 파라미터 입력

설정 탭에서 왼쪽/오른쪽 데이터, 키 컬럼, 조인 타입을 설정합니다.

---

파라미터

파라미터	필수	설명
left_data	O	왼쪽 데이터 (TabularData)
right_data	O	오른쪽 데이터 (TabularData)
left_key	O	왼쪽 키 컬럼
right_key	O	오른쪽 키 컬럼
operation		조인 타입 (아래 참조) — 기본: lookup
return_columns		오른쪽에서 가져올 컬럼 (lookup 전용)
case_sensitive		대소문자 구분 (기본: false)
null_handling		skip, include, fill — 기본: skip
fill_value		null 대체값 (fill 모드)

조인 타입

타입	설명
lookup	VLOOKUP — 오른쪽에서 컬럼 추가
merge_all	INNER JOIN — 양쪽 모두 일치하는 행만
merge_left	LEFT JOIN — 왼쪽 전체 + 오른쪽 매칭
merge_right	RIGHT JOIN — 오른쪽 전체 + 왼쪽 매칭
filter_in	WHERE IN — 오른쪽에 있는 키만 유지
filter_out	WHERE NOT IN — 오른쪽에 없는 키만 유지
compare	차이 비교 — 왼쪽만, 오른쪽만, 양쪽 모두

---

출력

lookup 결과

{
  "success": true,
  "data": {
    "rows": [
      {"id": 1, "name": "상품A", "price": 10000},
      {"id": 2, "name": "상품B", "price": 25000}
    ],
    "columns": ["id", "name", "price"],
    "row_count": 2,
    "metadata": {
      "operation": "lookup",
      "left_key": "id",
      "right_key": "product_id",
      "added_columns": ["price"]
    }
  }
}

---

사용 예시

주문 + 상품 데이터 병합

파라미터	값
left_data	{{ $('skill_orders').data_content.result }}
right_data	{{ $('skill_products').data_content.result }}
left_key	product_id
right_key	id
operation	lookup
return_columns	["name", "price"]

데이터 차이 비교

compare 타입으로 두 데이터셋의 차이를 확인합니다. 어제/오늘 데이터 비교, 시스템 간 데이터 정합성 검증 등에 활용합니다.

---

참고

• 대소문자 구분 없이 매칭하려면 case_sensitive: false를 사용합니다 (기본값).
• null_handling: fill로 매칭되지 않는 값을 지정한 값으로 채울 수 있습니다.
• 대용량 데이터는 배치 모드(batch_mode: true, 기본값)로 처리됩니다.