아이템 추가와 이동
컬렉션에 자산을 추가하거나 컬렉션·폴더 사이를 이동하는 방법을 안내합니다. Explorer에서 브라우즈 테이블·트리·컨텍스트 메뉴를 이용한 파일 탐색기 UX를 사용합니다.
항목 추가 메뉴 — 자원 생성과 파일 업로드
컬렉션·폴더 노드를 선택하면 우측 상세 헤더에 항목 추가 ▾ 버튼(+ 아이콘)이 나타납니다. 이 드롭다운에서 폴더와 자원을 만들거나, 파일을 업로드하거나, 기존 자원을 연결할 수 있습니다.
메뉴는 다음 순서로 구성됩니다.
| 항목 | 설명 |
|---|---|
| 새 폴더 | 현재 위치에 폴더를 만듭니다. 6종 자원 모두 폴더 안에 넣을 수 있습니다. |
| 빠른 추가… | 파일을 업로드해 데이터셋·코드를 자동 생성합니다(아래 Quick Upload 참고). |
| 데이터셋 | 템플릿 마법사로 데이터셋을 생성합니다. delta / kafka / rest / object 서브타입을 하위 메뉴에서 선택합니다. |
| 코드 | Python 또는 SQL 코드 자원을 생성합니다. |
| 지식 | 지식 베이스를 생성합니다(이어서 문서 업로드·크롤 흐름). |
| 파이프라인 | 컬렉션·폴더 컨텍스트를 지정한 상태로 파이프라인 편집기로 이동합니다. |
| 기존 항목에서 추가… | 이미 등록된 자원을 이 컬렉션에 연결합니다(아래 기존 자산을 컬렉션에 추가하기 참고). |
각 항목의 라벨은 동사가 아닌 명사구(예: "데이터셋", "파이프라인")로 표기됩니다.
이 메뉴에는 대시보드와 에이전트 항목이 없습니다. 두 자원은 좌측 트리에서 컬렉션을 우클릭한 생성 메뉴(또는 각 도메인 페이지 /dashboard, /agents)에서 만들 수 있습니다. 생성한 뒤에는 트리 leaf로 함께 노출됩니다.
Quick Upload (드래그 앤 드롭 + 헤더 편집 가능한 미리보기)
가장 빠른 추가 방법은 파일을 직접 드롭하는 것입니다. + 항목 추가 ▾ → 빠른 추가… 메뉴로도 같은 대화상자를 열 수 있습니다.
- 좌측 트리에서 대상 컬렉션 또는 폴더를 선택합니다.
- 파일(CSV / Parquet / JSON / Python / SQL)을 우측 패널이나 트리 노드 위로 드래그해 놓습니다.
- 파일은 확장자 기준으로 자동 분류됩니다.
.csv·.parquet·.json은 데이터셋으로,.py·.sql은 코드로 등록됩니다. - CSV·JSON처럼 테이블형 파일은 헤더 편집 가능한 미리보기(처음 몇 행)가 함께 열립니다. 컬럼명을 즉시 수정할 수 있으며, 각 컬럼 옆 AI 컬럼명 생성 버튼으로 헤더가 모호하거나 비어 있을 때 자동 제안을 받을 수 있습니다.
- 스키마 필드명 규칙에 맞지 않는 헤더는 강조 표시되어, 적용 전에 직접 또는 AI로 고칠 수 있습니다.
JSON 파일이 약 50MB를 넘으면 컬럼명 재매핑(헤더 편집 적용)이 생략되고 원본 그대로 업로드됩니다. 대규모 이관에는 ZIP 가져오기/내보내기를 사용하세요.
기존 자산을 컬렉션에 추가하기
이미 D.Hub에 등록된 자산을 컬렉션에 연결할 때 사용합니다. 만들기는 위의 항목 추가 메뉴로, 기존 연결은 아래 대화상자로 진행합니다.
- 좌측 트리에서 대상 컬렉션을 선택합니다.
- 상세 헤더의 + 항목 추가 ▾ → 기존 항목에서 추가… 를 선택합니다.
- 항목 관리 대화상자(공용 항목 선택기)가 열립니다(제목:
항목 관리: {컬렉션 이름}).
대화상자는 다음 기능을 제공합니다.
- 유형 탭: 전체 / 데이터셋 / 코드 / 파이프라인 / 지식 탭으로 필터링합니다(대시보드·에이전트는 이 선택기에서 다루지 않습니다).
- 검색: 이름이나 별칭으로 자산을 검색합니다.
- 추가된 항목 숨기기: 체크박스로 이미 컬렉션에 포함된 자산을 숨깁니다. 기본값은 켜짐이므로 처음에는 추가 가능한 자산만 보입니다.
- 체크박스 다중 선택: 여러 자산을 한 번에 선택합니다. 추가 가능한 자산을 선택하면 추가, 이미 컬렉션에 포함된 자산을 선택하면 제거로 처리됩니다.
하단 요약에는 {n}개 추가 • {m}개 제거가 표시됩니다. 변경사항 적용을 누르면 반영됩니다.
이미 포함된 자산을 빼려면 추가된 항목 숨기기를 끄거나(비어 있을 때 나타나는 전체 항목 표시 링크 사용) 현재 구성원을 표시한 뒤, 제거할 자산을 선택하고 변경사항 적용을 누릅니다. 이 동작은 컬렉션 연결만 해제하며 자산 자체는 삭제되지 않습니다. 자세한 내용은 컬렉션 편집의 아이템 제거 절을 참고하세요.
트리에서 드래그 앤 드롭으로 이동
Collection Tree v2는 6종 자원 모두 드래그 앤 드롭으로 이동 가능합니다.
- 자원 leaf 또는 폴더를 트리에서 끌어 대상 폴더/컬렉션 위로 가져갑니다.
- drop indicator가 표시되면 떨어뜨려 이동을 확정합니다.
- 이동은 서버에서 처리되며, 권한 상한(Ceiling) 등 서버 검증을 통과하면 반영되고 트리·테이블이 동기화됩니다. 서버가 거부하면 해당 이동은 실패로 처리됩니다.
폴더 자체의 컬렉션 간 이동은 지원되지 않습니다(자원 단위만). 같은 컬렉션 내 다른 폴더로의 이동은 가능합니다.
Explorer 브라우즈 테이블에서 이동하기
컬렉션/폴더를 선택하면 우측 패널의 폴더-as-page 테이블에서 파일 탐색기와 유사한 다중 선택·일괄 이동이 가능합니다.
- 테이블에서 이동할 자산의 체크박스를 선택합니다(여러 개 가능).
- 상단 일괄 액션 바에서
이동을 클릭합니다(일괄 액션 바는 이동·삭제만 제공합니다). - 경로 피커 다이얼로그(검색 가능한 컬렉션 → 폴더 트리)에서 대상을 선택합니다. 선택한 자산이 이미 있는 위치는 비활성화되어 고를 수 없습니다.
이동을 확정하면 자산이 순차 이동됩니다. 서버가 거부하면 해당 자산은 실패로 표시되고, 일부만 실패한 경우 다이얼로그가 유지되어 재시도할 수 있습니다.
경로 피커는 6종 모두를 지원하므로, 한 번의 선택으로 여러 타입 자원을 같은 폴더로 일괄 이동할 수 있습니다.
컨텍스트 메뉴로 이동
- 자산: 우클릭 →
이동 - 폴더: 우클릭 →
이동(폴더 자체의 컬렉션 간 이동은 미지원; 같은 컬렉션 내 다른 폴더로만 이동 가능)
우클릭 만들기
트리에서 컬렉션·폴더를 우클릭하면 컨텍스트에 맞는 생성 메뉴가 열립니다. 메뉴 항목은 위의 항목 추가 와 유사하지만, 만들어지는 자원은 우클릭한 위치를 부모로 사용합니다. 컬렉션 우클릭 생성 메뉴에는 대시보드·에이전트도 포함됩니다.
이름 변경 (alias)
- 컬렉션·폴더·자산의 컨텍스트 메뉴에서
이름 변경을 선택하면 별칭(alias) 을 편집할 수 있습니다. - 별칭은 사용자에게 보여 줄 표시 이름이며, 시스템 이름(name)은 식별자로 유지됩니다.
- 브레드크럼과 목록에는 별칭이 우선 표기되고 별칭이 없으면 시스템 이름이 표시됩니다.
복제 (duplicate)
데이터셋·코드·파이프라인·지식 행을 우클릭 → 복제 를 선택하면 복제 대화상자가 열립니다.
- 새 이름: 소문자로 시작하고 소문자·숫자·밑줄(
_)만 사용하며 최대 128자입니다. - 대상 컬렉션: 복제본을 둘 컬렉션을 선택합니다(기본값은 현재 컬렉션). 별칭·설명·태그도 함께 지정할 수 있습니다.
- 별칭은 원본 별칭 뒤에
_copy가 붙은 값이 기본 제안되며, 시스템 이름에는 충돌을 피하기 위한 고유 접미사가 자동으로 붙습니다.
복제가 끝나면 대상 컬렉션이 새로고침되어 복제본이 목록에 나타납니다.
삭제
- 자산 삭제: 우클릭 →
삭제. 삭제 확인 대화상자에서 자산 이름을 그대로 입력해 확인합니다. 데이터셋처럼 오래 걸리는 정리 작업은 플로팅 패널에 비동기로 진행률이 표시됩니다(정리 패널 문서 참조). - 폴더 삭제: 폴더 삭제 대화상자에서 내용 처리 방식을 선택합니다.
- 내용을 상위로 이동(기본): 하위 폴더와 자산을 한 단계 위로 올리고 폴더만 삭제합니다.
- 폴더와 모든 내용 삭제: 중첩된 모든 폴더와 그 안의 모든 리소스(데이터셋·파이프라인·코드·지식·대시보드·온톨로지 엔티티/관계·에이전트)를 영구 삭제합니다. 이 옵션은 폴더 이름을 입력해야 확인됩니다.
- 컬렉션 삭제: 컬렉션을 삭제하면 하위 자산까지 항상 함께 영구 삭제됩니다(보존 옵션 없음). 자세한 절차는 컬렉션 편집 문서를 참고하세요.
참조 경고
컬렉션을 삭제할 때 외부 참조 검사가 자동으로 실행되어, 다른 리소스(파이프라인·온톨로지 관계 등)가 이 컬렉션의 자산을 참조하면 경고와 참조 목록이 표시됩니다. 개별 자산을 삭제할 때는 이 사전 검사가 없으므로, 참조 관계를 미리 확인하세요.