노드 연결

파이프라인에서 노드 간 연결(Edge)은 데이터의 흐름 방향과 의존성을 정의합니다. 올바른 연결을 통해 데이터가 소스에서 처리 단계를 거쳐 최종 목적지까지 자연스럽게 흘러가도록 설계합니다.

엣지(연결) 만들기

노드 간 연결은 출력 포트에서 입력 포트로 드래그하여 생성합니다:

1. 선행 노드(Upstream)의 오른쪽 핸들(출력 포트)에 마우스를 가져갑니다.
2. 핸들이 활성화되면 클릭 후 드래그합니다.
3. 후행 노드(Downstream)의 왼쪽 핸들(입력 포트)에 드롭합니다.
4. 연결선(Edge)이 생성되며 데이터 의존성이 설정됩니다.

팁

연결할 수 없는 포트 위에 드래그하면 시각적으로 거부 표시가 나타납니다. 유효한 대상만 하이라이트 됩니다.

데이터 흐름 규칙

노드 간 연결에는 다음 규칙이 적용됩니다:

허용되는 연결

출발 노드	도착 노드	데이터 흐름
Dataset →	Code	데이터셋을 코드 노드의 입력으로 읽기
Code →	Dataset	코드 노드의 처리 결과를 데이터셋에 쓰기
Code →	Code	중간 처리 결과를 다음 코드 노드로 전달

허용되지 않는 연결

출발 노드	도착 노드	제한 사유
Dataset →	Dataset	데이터셋 간 직접 연결 불가 — 중간에 Code 노드 필요

순환 참조(Cycle)는 허용되지 않습니다

노드 간 연결이 순환 구조를 형성하면 파이프라인을 저장할 수 없습니다. 예를 들어, A → B → C → A와 같이 데이터 흐름이 원점으로 되돌아오는 구조는 무한 루프를 유발하므로 허용되지 않습니다.

자동 매핑

Code 노드와 Dataset 노드를 연결하면, 스키마가 호환되는 경우 입출력 변수가 자동으로 매핑됩니다.

자동 매핑 동작 방식

1. 연결 시: Code 노드와 Dataset 노드를 연결하면 코드 내 입출력 변수명과 데이터셋 ID를 비교합니다.
2. 스키마 호환 확인: 연결된 데이터셋의 스키마(컬럼명, 데이터 타입)가 코드에서 기대하는 형식과 일치하는지 검사합니다.
3. 매핑 적용: 호환되는 경우 자동으로 변수 매핑이 설정됩니다.

정보

자동 매핑은 Inspector 패널의 Connections 탭에서 확인하고 수정할 수 있습니다. 매핑이 올바르지 않은 경우 수동으로 변경하세요.

다중 입출력

하나의 Code 노드에 여러 Dataset 노드를 연결할 수 있습니다.

다중 입력 예시

• 여러 데이터셋을 하나의 Code 노드에 입력으로 연결하여 조인, 병합 등의 처리를 수행합니다.
• 각 입력은 Code 노드 내에서 별도의 변수로 참조됩니다.

다중 출력 예시

• 하나의 Code 노드에서 조건에 따라 여러 데이터셋에 결과를 분배할 수 있습니다.

엣지 관리

연결 삭제

• 연결선(Edge)을 클릭하여 선택한 후 Delete 키를 누릅니다.
• 또는 연결선을 우클릭하여 Delete 메뉴를 선택합니다.

연결 변경

기존 연결을 다른 노드로 변경하려면:

1. 기존 연결을 삭제합니다.
2. 새로운 대상 노드로 다시 연결합니다.

연결 상태 확인

Inspector 패널의 Connections 탭에서 선택한 노드의 모든 입출력 연결을 확인할 수 있습니다:

항목	설명
Upstream	현재 노드에 데이터를 제공하는 선행 노드 목록
Downstream	현재 노드의 결과를 받는 후행 노드 목록
Variable Mapping	코드 변수와 데이터셋 간 매핑 상태