데이터 리니지
GenD의 데이터 리니지(Lineage) 기능은 테이블 간의 데이터 흐름과 의존성을 추적합니다. 상류(upstream)에서 하류(downstream)로의 데이터 변환 경로를 시각화하고, 변경 시 영향 범위를 분석합니다.
주요 기능
- 계보 그래프 조회: 특정 테이블을 중심으로 upstream/downstream 의존 관계를 그래프로 조회합니다
- 영향 분석: 테이블 변경 시 영향을 받는 하위 테이블, 뷰, 데이터 마트를 파악합니다
- 계보 엣지 생성: 테이블 간의 데이터 흐름 관계를 수동으로 등록합니다
- 깊이 제어: 조회 시 탐색 깊이를 지정하여 관련 범위를 조절합니다
계보 그래프 구조
Source Table A ──ETL──> Staging Table B ──Transform──> Data Mart C
Source Table D ────────────────────────/
각 노드는 테이블을 나타내고, 엣지는 데이터 흐름 방향을 나타냅니다.
사용 방법
거버넌스 > 계보 메뉴에 들어가면 다음 세 가지 진입점으로 테이블을 선택할 수 있습니다.
- 좌측 카탈로그 트리 —
iceberg/hive등 카탈로그를 펼쳐서 스키마·테이블을 클릭하면 바로 조회됩니다. 트리에서 노드를 토글하면 해당 카탈로그의 스키마·테이블이 lazy load 됩니다. - 상단 "리니지가 등록된 테이블" 칩 — 시스템에 lineage edge가 등록된 테이블만 칩 형태로 노출됩니다. 어떤 테이블에 흐름이 잡혀 있는지 모를 때 가장 빠른 진입 경로입니다.
- "최근 조회" 칩 — 직전에 본 테이블 최대 20개. 브라우저별로 보존됩니다.
선택 후 화면:
- 우측 패널에 upstream(파란 카드) → 현재 테이블 → downstream(초록 카드) 그래프가 펼쳐집니다.
- 상하류 카드를 클릭하면 그 테이블이 새 중심이 되어 탐색을 이어갈 수 있습니다.
- 상단 우측의 영향도 분석 버튼으로 다운스트림 전체 영향 범위를 한 번에 확인합니다.
- URL에
?catalog=<c>&schema=<s>&table=<t>가 자동 반영되므로, 현재 선택 상태를 그대로 공유할 수 있습니다 (북마크·메신저 링크 등).
API 엔드포인트
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/lineage/{catalog}/{schema}/{table} | 계보 그래프 조회 (?depth= 옵션) |
| GET | /api/v1/lineage/{catalog}/{schema}/{table}/impact | 영향 분석 |
| GET | /api/v1/lineage/tables | lineage edge가 등록된 unique 테이블 목록 (UI "리니지 등록 테이블" 칩에서 사용) |
| POST | /api/v1/lineage/edges | 계보 엣지 생성 |
AI Agent Chat으로 수행하기
이 페이지의 작업을 AI에게 자연어로 요청할 수 있습니다. 페이지 상단의 AI에게 요청 버튼을 클릭하거나, AI 에이전트 채팅에서 직접 질문하세요.
예시:
- "orders 테이블의 데이터 리니지 보여줘"
- "리니지 영향도 분석해줘"
자세한 내용은 AI Agent Chat 가이드를 참조하세요.