노드 연결
파이프라인 캔버스에서 노드의 출력 핸들을 다음 노드의 입력 핸들에 연결합니다. 연결선의 방향과 분기 조건을 확인해 데이터 흐름을 구성합니다.
연결선 만들기
노드끼리의 연결은 출력 연결점에서 입력 연결점까지 끌어 만듭니다.
- 선행 노드의 오른쪽 출력 연결점에 마우스를 가져갑니다.
- 연결점을 누른 채 입력 연결점까지 끕니다.
- 후행 노드의 왼쪽 입력 연결점에 놓습니다.
- 연결선이 생기고 두 노드 사이의 데이터 흐름이 설정됩니다.
데이터 흐름 구성
일반적으로 데이터셋·엔티티·관계에서 코드를 거쳐 출력 자산으로 흐르도록 연결합니다. 엔티티와 관계 노드는 데이터셋처럼 입력 또는 출력으로 사용합니다.
권장 연결
| 출발 노드 | 도착 노드 | 데이터 흐름 |
|---|---|---|
| 데이터셋 / 엔티티 / 관계 | 코드 | 데이터를 코드 노드의 입력으로 읽습니다. |
| 코드 | 데이터셋 / 엔티티 / 관계 | 코드 노드의 처리 결과를 씁니다. |
| 코드 | 코드 | 중간 처리 결과를 다음 코드 노드로 전달합니다. |
편집기는 데이터셋끼리의 직접 연결, 이벤트 스텝과 데이터셋 연결, 순환 연결을 만들 때 자동으로 차단하지 않습니다. 연결선이 만들어졌다는 사실만으로 실행 가능한 구성이 보장되지는 않습니다. 데이터 변환은 코드 노드를 사이에 두고, 파이프라인은 한 방향으로 흐르는 비순환 구조로 설계합니다. 실행 결과와 단계 오류는 파이프라인 오류에서 확인합니다.
입출력 설정
코드 노드와 데이터셋·엔티티·관계 노드를 연결하면 코드 노드의 옵션 탭에 입력·출력 연결이 표시됩니다. 연결할 때 스키마 타입을 비교하거나 필드를 자동으로 연결하지 않습니다.
옵션 탭에서 입력과 출력별로 다음을 지정합니다.
- 읽기 모드(입력): 증분 / 전체 중에서 선택합니다.
- 쓰기 모드(출력): 추가 / 덮어쓰기 / 병합 중에서 선택합니다.
스텝 옵션
옵션 탭 상단에는 입출력 연결과 별도로 스텝 옵션 JSON 필드가 표시됩니다. 입력한 JSON 객체는 실행할 때 options로 전달됩니다. 코드에서는 run 함수의 options 매개변수로 읽습니다.
- 값은 JSON 객체여야 합니다. 형식이 올바르지 않으면 오류가 표시되고 저장되지 않습니다.
- 필드를 비우거나
{}로 두면 스텝 옵션 없이 실행됩니다.
기존 자산 재사용과 중복 이름
옵션 탭의 입력·출력 선택기에서 기존 데이터셋·엔티티·관계를 선택해 연결합니다. 파이프라인에 같은 유형·같은 이름의 노드가 있으면 새 이름으로 저장 창이 열립니다. 같은 유형의 노드는 파이프라인 안에서 서로 다른 테이블 이름을 사용해야 합니다.
- 창에는 겹치지 않는 새 이름이 미리 제안됩니다(예:
orders→orders_copy). - 이름을 확인하고 복제하면 원본은 그대로 두고 새 이름의 사본이 만들어져 이 연결에 이어집니다.
- 이름은 소문자로 시작하며 소문자·숫자·밑줄만 사용합니다.
다중 입출력
하나의 코드 노드에 여러 데이터셋 노드를 연결합니다.
다중 입력 예시
- 여러 데이터셋을 하나의 코드 노드에 입력으로 연결해 조인이나 병합을 수행합니다.
- 코드 노드는 각 입력을 별도의 변수로 참조합니다.
다중 출력 예시
하나의 코드 노드에 여러 출력 데이터셋을 연결하면 각 연결이 옵션 탭에 표시됩니다.
연결선 관리
연결 삭제
- 연결선 위에 마우스를 올리면 나타나는 × 버튼을 눌러 즉시 제거합니다.
연결 변경
기존 연결은 다음 순서로 다른 노드에 연결합니다.
- 기존 연결을 삭제합니다.
- 새로운 대상 노드로 다시 연결합니다.
연결 상태 확인
코드 노드의 옵션 탭에 모든 입출력 연결이 표시됩니다.
| 항목 | 설명 |
|---|---|
| 입력 | 코드 노드에 데이터를 제공하는 자산과 읽기 모드를 표시합니다. |
| 출력 | 코드 노드의 결과를 받는 자산과 쓰기 모드를 표시합니다. |