버전 관리
D.Hub의 주요 리소스(데이터셋·코드·파이프라인·지식)는 변경 이력이 버전별로 관리됩니다. 각 리소스 상세 화면의 버전 기록 탭에서 버전 목록을 확인하고, 이전 버전을 미리 보거나 복원할 수 있습니다.
버전이 생성되는 시점
- 리소스를 생성하면 최초 버전이 기록됩니다.
- 메타데이터(별칭·태그·설명 등)나 내용(코드 스크립트, 파이프라인 Step 구성, 데이터셋 스키마·데이터)을 변경하면 새 버전이 생성됩니다.
- 이전 버전은 삭제되지 않고 그대로 남으므로 필요할 때 되돌릴 수 있습니다.
버전 기록 탭
리소스 상세 화면에서 버전 기록 탭을 열면 전체 버전 목록을 타임라인으로 볼 수 있습니다. 데이터셋·코드·파이프라인·지식이 모두 이 탭을 제공합니다.
각 버전 항목에는 다음 정보가 표시됩니다.
| 항목 | 설명 |
|---|---|
| 버전 라벨 | v1, v2 … 순번 (전체 버전 ID는 툴팁) |
| 최신 | 최신 버전 여부 배지 |
| 수정 시각 | 해당 버전이 생성된 시각(상대 시간 + 전체 시각) |
| 작성자 | 해당 버전을 만든 사용자 (아바타에 호버하면 소유자 미리보기) |
좌측에는 전체 버전 수와 마지막 수정 시각 등 버전 통계가 함께 표시됩니다.
특정 버전 미리보기
버전 항목의 미리보기를 누르면 그 시점의 리소스 상태를 펼쳐 볼 수 있습니다.
- 데이터셋: 해당 버전의 메타데이터(별칭·유형·설명·태그)
- 코드: 해당 버전의 코드 내용
- 파이프라인: 해당 버전의 별칭·유형(
batch/event)·설명·태그·Step 목록 - 지식: 해당 버전의 메타데이터
버전 복원
이전 버전을 현재 버전으로 되돌릴 수 있습니다. 버전 항목의 복원 버튼(데이터셋·파이프라인·지식은 복원, 코드는 버전 복원하기)을 누르면 확인 모달이 뜹니다. "현재 내용이 선택한 버전으로 덮어쓰기됩니다"라는 경고를 확인하면 복원이 적용됩니다.
경고
복원은 현재 상태를 선택한 버전으로 덮어씁니다. 코드·파이프라인을 복원하면 이를 참조하는 다른 리소스의 동작에 영향을 줄 수 있으니 영향 범위를 먼저 확인하세요.
코드 버전 비교와 다운로드
코드 리소스의 버전 기록 탭은 추가 기능을 제공합니다.
- 버전 비교: 두 버전을 선택하면 Diff 뷰어로 변경 내역을 비교합니다. 나란히 보기 / 통합 보기를 전환할 수 있고, 추가·삭제 줄 수가 함께 표시됩니다.
- 다운로드: 선택한 버전의 코드 파일을
.py또는.sql로 내려받습니다.
버전 비교(Diff)는 코드 리소스에서만 제공됩니다. 데이터셋은 비교 자리가 마련되어 있으나 아직 활성화되지 않았고, 파이프라인·지식은 비교 도구가 없습니다 — 코드 외 리소스는 미리보기와 복원을 사용하세요.
리소스별 참고
- 데이터셋: 버전 기록 탭은 메타데이터 버전 이력을 보여 줍니다. 데이터 자체의 변경(파일 업로드·스키마 변경 등)은 데이터셋 문서의 업로드·스키마 절차를 참고하세요.
- 코드: 비교·다운로드를 포함한 전체 흐름은 코드 문서를 참고하세요.
- 파이프라인: 버전 미리보기에서 Step 구성을 볼 수 있습니다. 편집은 파이프라인 (컬렉션)을 참고하세요.
다음 단계
- 데이터셋 — 데이터셋의 스키마 및 데이터 관리
- 코드 — 코드 아티팩트 관리
- 파이프라인 (컬렉션) — 파이프라인 상태 확인
- 파이프라인 실행 — 배치 실행 및 모니터링