본문으로 건너뛰기

실행

설계한 파이프라인을 저장하고 실행합니다. 실행 중에는 노드 상태를 확인하고 완료 후에는 실행 기록에서 단계별 결과를 검토합니다.

배치 실행 중 상태와 처리 레코드 수가 표시된 파이프라인 캔버스

변경 사항 저장​

실행하기 전에 변경 사항을 반드시 저장해야 합니다. 상단 툴바의 저장을 누르거나 ⌘S(macOS) / Ctrl+S(Windows)를 사용합니다. 컬렉션·폴더를 거치지 않고 편집기로 바로 들어왔다면 저장할 위치를 먼저 고릅니다.

유효성 검사

실행 전에는 파이프라인의 저장 컬렉션이 정해져 있는지, 참조 자산이 같은 컬렉션에 속하는지 확인합니다. 연결·필수 설정 누락을 모두 검사하거나 문제 노드를 표시하지는 않습니다. 구조나 설정 오류는 실행 결과와 코드 노드의 히스토리 탭에서 확인합니다.

수동 실행​

batch 파이프라인​

  1. 상단 툴바의 지금 실행을 누릅니다.
  2. 실행이 시작되면 버튼이 중지로 바뀌고 연결선에 실행 상태가 표시됩니다.
  3. 실행을 멈추려면 중지를 누릅니다.

event 파이프라인​

  1. 상단 툴바의 등록을 눌러 이벤트 수신을 시작합니다. 구독할 이벤트 토픽은 파이프라인 설정에서 하나 이상 지정합니다. 여러 토픽의 추가·검증은 파이프라인 설정에서 확인합니다.
  2. 파이프라인이 수신 중 상태로 바뀝니다. 이벤트가 들어오면 파이프라인이 실행됩니다.
  3. 이벤트 수신을 멈추려면 등록 해제를 누릅니다.

등록 / 등록 해제는 event 파이프라인에만 표시됩니다. batch 파이프라인에는 지금 실행 / 중지가 표시됩니다.

일정 설정​

파이프라인을 정해진 주기로 실행합니다.

  1. 상단 툴바의 설정을 누릅니다.
  2. 일정 탭에서 주기를 설정합니다.
  3. 설정을 저장하면 파이프라인 목록에 일정 배지가 표시됩니다.

일정 입력 항목과 UTC 기준은 실행 일정 설정하기에서 확인합니다.

실행 상태 확인하기​

실시간 상태​

실행 중에는 각 노드 위에 상태 아이콘·라벨과 처리한 레코드 수·소요 시간이 나타납니다. 실행 중인 노드는 강조 표시됩니다.

상태설명
실행 중 (running)현재 실행 중입니다.
성공 (ok·ready)모든 단계를 완료했습니다.
실패 (error·failed)실행에 실패했습니다.
대기 (pending)선행 노드가 끝나기를 기다립니다.

실행 이력 바​

상단 툴바의 실행 이력 바는 저장된 파이프라인의 최근 실행을 상태별 색으로 표시합니다.

  • 각 막대는 개별 실행 건이며 색으로 성공/실패를 구분합니다.
  • 막대에 마우스를 올리면 실행 번호·상태·시각·소요 시간이 표시됩니다.
  • 배치별 상세와 단계 로그는 코드 노드의 히스토리 탭에서 확인합니다.

배치 상세 정보​

코드 노드의 히스토리 탭에서 배치를 선택하면 다음 정보를 표시합니다.

  • 배치 상태와 소요 시간
  • 단계별 상태: 각 단계의 실행 결과와 시작·종료 시각을 표시합니다.
  • 오류 상세: 실패한 단계의 설명과 스택트레이스를 표시합니다.

오류 처리​

실행 실패 알림​

알림 범위는 실행 방식에 따라 다릅니다.

  • 수동 배치 실행: 실행 상태 조회가 완료되면 성공·실패 토스트를 표시합니다. 브라우저 알림을 허용했다면 데스크톱 알림을 보내고 탭 제목에 ✓·✗를 잠시 표시합니다.

  • 이벤트 실행: 이벤트 수신 중 확인된 실패에는 오류 토스트가 표시될 수 있습니다. 이벤트 성공에는 수동 배치와 같은 데스크톱 알림이나 탭 제목 표시를 제공하지 않습니다.

  • 실행·등록 요청 자체의 실패: 단계 실행이 시작되기 전에 실패하면 토스트나 실행 기록이 남지 않을 수 있습니다. 버튼과 실행 상태가 바뀌지 않으면 네트워크와 서비스 상태를 확인한 뒤 다시 시도합니다.

  • 단계별 오류는 코드 노드 히스토리 탭에서 스택트레이스로 확인합니다.

  • 노드 실행이 시작되기 전에 실패하면 단계별 기록과 오류 알림이 모두 남지 않을 수 있습니다.

상태를 알 수 없는 실행​

실행 상태를 잇달아 읽지 못하면 약 1분 뒤 상태 확인을 멈추고 파이프라인 상태를 알 수 없음을 표시합니다. 네트워크와 서비스 상태를 확인한 뒤 다시 실행합니다.

실행 실패 시 확인 사항​

  1. 실패한 코드 노드를 선택해 속성 패널을 엽니다.
  2. 히스토리 탭에서 실패한 배치를 선택합니다.
  3. 실패한 단계의 설명과 스택트레이스를 확인합니다. 스택트레이스의 복사를 누르면 내용이 클립보드에 복사됩니다.

일반적인 오류 유형​

오류 유형원인해결 방법
ConnectionError데이터 소스 연결 실패네트워크, 인증 정보 확인
Schema Mismatch스키마 불일치입출력 스키마 매핑 확인
Code ErrorPython/SQL 코드 오류코드 문법, 로직 수정
Resource Limit리소스 부족데이터 크기 축소, 파티션 조정
Timeout실행 시간 초과쿼리 최적화, 타임아웃 설정 조정