버전 기록
D.Hub은 컬렉션과 여러 자산의 변경 이력을 버전별로 저장합니다. 자산마다 진입 위치와 미리보기·복원 범위가 다르므로 작업 전에 아래 표를 확인합니다.
버전이 생성되는 시점
- 자산을 만들면 첫 버전이 기록됩니다.
- 별칭·태그·설명이나 자산 구성을 변경하면 새 버전이 생성됩니다.
- 이전 버전은 삭제되지 않습니다.
버전 기록 탭
자산 상세나 편집 화면에서 버전 기록 또는 버전 이력을 열면 전체 버전이 시간순으로 표시됩니다.
각 버전 항목에는 다음 정보가 표시됩니다.
| 항목 | 설명 |
|---|---|
| 버전 라벨 | v1, v2 … 순번 (전체 버전 번호는 마우스를 올리면 표시) |
| 최신 | 최신 버전 여부 배지 |
| 수정 시각 | 해당 버전이 생성된 시각(상대 시간 + 전체 시각) |
| 작성자 | 해당 버전을 만든 사용자(아바타에 마우스를 올리면 소유자 미리보기 표시) |
좌측에는 전체 버전 수와 마지막 수정 시각 등 버전 통계가 함께 표시됩니다.
자산별 미리보기와 복원
| 자산 | 진입 위치 | 미리보기 | 복원 |
|---|---|---|---|
| 컬렉션 | 컬렉션 개요의 버전 기록 | 컬렉션 메타데이터 | 가능 |
| 데이터셋 | 상세 버전 기록 | 데이터 샘플 또는 별도 메타데이터 변경 이력 | 데이터 버전과 메타데이터 복원을 각각 수행 |
| 코드 | 상세 버전 기록 | 코드 본문. 메타데이터 변경 이력은 별도 표시 | 가능. 비교·다운로드 추가 제공 |
| 파이프라인 | 상세 버전 기록 | 별칭·유형·설명·태그·단계 구성 | 가능 |
| 지식 | 상세 버전 기록 | 지식 구성 | 가능 |
| 지식 문서 | 지식 버전 화면의 문서별 섹션 | 개별 문서 버전 | 화면에서 제공하는 문서별 작업 사용 |
| 대시보드 | 컬렉션 상세의 대시보드 버전 기록 | 위젯·설정 차이 요약과 스냅샷 | 가능 |
| 에이전트 | 컬렉션 상세의 에이전트 버전 기록 | 모델·도구·프롬프트 등 구성 | 가능 |
| 도구·액터 | 각 편집 화면의 버전 기록 | 실행 구성 | 가능 |
| 시맨틱 테이블 | 편집 화면의 버전 기록 | 컬럼·메트릭·설명 구성 통계와 스냅샷 | 가능 |
| 커넥터 | 편집 화면의 버전 기록 | 연결 구성 | 가능 |
| 온톨로지 엔티티·관계 | 빌더 속성 패널의 버전 이력 | 변경 타임라인 | 읽기 전용 |
버전 항목의 미리보기에서 해당 시점의 구성을 확인합니다. 복원, 버전 복원하기 또는 메타데이터 복원이 표시되는 자산은 확인 창을 거쳐 선택한 상태를 현재 버전으로 다시 저장합니다.
데이터셋의 데이터 버전과 메타데이터 변경 이력은 다릅니다. 메타데이터 복원은 별칭·설명·태그·옵션·스키마만 되돌리며 테이블 데이터는 바꾸지 않습니다. 컬렉션과 코드에서도 메타데이터 이력과 자산 콘텐츠 버전을 구분합니다.
경고
복원은 현재 상태를 선택한 버전으로 덮어씁니다. 도구·액터를 복원하기 전에 참조 중인 에이전트를 확인하고, 실행 중인 에이전트에는 저장 후 재배포합니다. 대시보드·파이프라인·커넥터 등은 복원 후 소비 화면과 실행 결과를 다시 확인합니다.
코드 버전 비교와 다운로드
코드의 버전 기록 탭에서는 버전을 비교하고 파일을 내려받습니다.
- 버전 비교: 버전 하나를 선택하면 선택한 버전과 바로 이전 버전의 변경 내역을 변경 비교 화면에서 확인합니다. 가장 오래된 버전에는 비교할 이전 버전이 없어 선택한 내용만 표시됩니다. 나란히 보기 / 통합 보기를 전환할 수 있고 추가·삭제 줄 수가 함께 표시됩니다.
- 다운로드: 선택한 버전의 코드 파일을
.py또는.sql로 내려받습니다.
나란히 보기·통합 보기로 코드 줄을 비교하고 파일을 내려받는 작업은 코드에서만 제공합니다. 다른 자산은 각 화면의 구성 미리보기와 복원을 사용합니다.
자산별 확인 항목
- 데이터셋: 데이터 스냅샷과 메타데이터 변경 이력은 데이터셋에서 확인합니다.
- 코드: 본문 비교·다운로드와 별도 메타데이터 이력은 코드에서 확인합니다.
- 파이프라인: 미리보기에서 단계 구성을 확인한 뒤 컬렉션의 파이프라인에서 실행 설정을 점검합니다.
- 에이전트·도구·액터: 복원 후 에이전트 배포에서 재배포 필요 여부를 확인합니다.
- 시맨틱 테이블: 시맨틱 테이블에서 연결·컬럼·메트릭 구성을 확인합니다.
- 온톨로지: 온톨로지 빌더의 타임라인은 읽기 전용이며 일반 복원 절차를 적용하지 않습니다.