본문 바로가기
문서 목차
AkashiQ v0.1.0 · 데이터

Data Factory — 수집 진입점

외부 시스템 데이터를 수집해 레이크하우스로 가져오는 화면의 구조와 공통 절차

QUANTUM C&S

Data Factory 는 외부 시스템의 데이터를 AkashiQ로 가져오는 진입점입니다. 수집 작업을 만들어 실행하고, 결과를 데이터셋으로 등록하고, 정기 실행을 파이프라인에 맡기는 흐름을 한 화면에서 처리합니다.

실시간 변경 수집(CDC)과 설비 telemetry는 이 화면이 아니라 스트리밍 경로로 동작합니다. → Pipeline Ops

네 개 탭

[ 데이터 수집 ]  →  [ DataHub 등록 ]  →  [ 파이프라인 실행 ]     [ Spark Job ]
  외부 → 저장소       저장소 → 데이터셋      수집 작업 → Airflow    SparkApplication
역할
데이터 수집 수집 작업을 만들고 즉시 실행합니다. → 소스별 수집 설정
DataHub 등록 적재된 결과를 데이터셋으로 등록합니다. → DataHub 등록
파이프라인 실행 수집 작업을 Airflow DAG으로 실행해 이력과 재시도를 남깁니다.
Spark Job Spark 작업의 제출 상태와 결과를 확인합니다.

지원 소스 유형

유형 대상
DB 연동 Trino 카탈로그로 연결된 RDB 테이블 · 뷰
API 연동 HTTP API 응답, Jira 이슈, Confluence 페이지
RSS 수집 RSS · Atom 피드
직접 등록 이미 저장소에 있는 객체를 수동 등록

문서관리시스템(EDMS)은 전용 커넥터로 동기화합니다. → EDMS 연동

공통 절차

  1. 데이터 수집 탭에서 작업을 만듭니다. 소스 유형과 연결 정보, 출력 포맷을 입력합니다.
  2. 저장 후 실행합니다. 진행 상태가 같은 행에서 갱신됩니다.
  3. 결과 파일이 저장소에 적재되면 DataHub 등록 탭에 후보로 나타납니다.
  4. 등록하면 Data Hub에서 검색 · 프리뷰가 가능해집니다.
  5. 반복 실행이 필요하면 파이프라인 실행 탭에서 Airflow로 실행합니다.

실행 상태

상태 의미
queued 실행 대기
running 실행 중
success 정상 완료
failed 오류로 종료
cancelled 사용자가 취소

각 작업의 실행 이력에서 시작 · 종료 시각, 적재 행 수, 결과 파일 경로, 오류 메시지를 확인합니다.

적재 경로 규칙

수집 결과는 다음 규칙으로 저장됩니다.

s3://<staging 버킷>/
  └── <소스 유형>/          # database, rss, atlassian-jira 등
      └── <작업 ID>/
          └── <실행 ID>.jsonl   # 또는 .csv

출력 포맷은 작업 생성 시 JSONL 또는 CSV로 선택합니다.

⚠️ 주의

staging 영역의 객체는 데이터셋으로 등록되기 전까지 운영 정책에 따라 정리될 수 있습니다. 계속 사용할 결과는 반드시 데이터셋으로 등록하세요.

파이프라인 실행 탭

수집 작업의 정의는 Data Factory가 그대로 소유하고, Airflow는 실행을 트리거하는 도구로 사용합니다. 그래서 화면에서 만든 작업을 다시 만들지 않고도 이력 · 재시도 · 로그를 Airflow 표준으로 관리할 수 있습니다.

확인 가능한 정보 설명
실행 목록 실행 ID, 상태, 시작 · 종료 시각, 소요 시간
태스크 로그 실패한 태스크의 오류 메시지
재실행 실패 지점부터 다시 실행

파이프라인 운영 기능의 전체 범위는 Pipeline Ops에서 설명합니다.

Spark Job 탭

Spark 작업의 제출 · 실행 상태를 요약합니다.

지표 의미
전체 Jobs 등록된 Spark 작업 수
실행 중 RUNNING
완료 COMPLETED
실패 FAILED

대량 가공, 재구축, 학습 데이터 생성처럼 배치 수집으로 처리하기 어려운 작업이 여기에서 실행됩니다.

권한

역할 가능한 동작
일반 사용자 작업 목록과 실행 이력 조회
데이터 엔지니어 작업 생성 · 수정 · 실행, 데이터셋 등록
플랫폼 관리자 파이프라인 등록, 스케줄 정책 변경

현재 지원하지 않는 것

  • 화면에서 DAG 파일을 직접 작성하거나 생성하지 않습니다.
  • 수집 화면에서 스케줄(cron)을 직접 등록하지 않습니다. 정기 실행은 파이프라인으로 등록합니다.