본문으로 건너뛰기
버전: v0.1.0

아이템 추가와 이동

컬렉션에 자산을 추가하거나 컬렉션·폴더 사이를 이동하는 방법을 안내합니다. Explorer에서 브라우즈 테이블·트리·컨텍스트 메뉴를 이용한 파일 탐색기 UX를 사용합니다.

"+ 항목 추가" 메뉴 — 6종 자원 + 새 폴더​

컬렉션·폴더 노드 상세 패널 헤더의 + 항목 추가 ▾ 드롭다운에서 6종 자원과 폴더를 만들 수 있습니다.

스크린샷 TODO

컬렉션 상세 헤더의 + 항목 추가 ▾ 드롭다운이 열린 상태. 메뉴 항목이 가운데 정렬된 아이콘 + 단어 라벨 + 한 줄 설명으로 구성되어 있어야 합니다.

메뉴 항목은 다음 순서로 정렬됩니다.

항목설명
새 폴더현재 위치에 폴더를 만듭니다. 6종 자원 모두 폴더 안에 넣을 수 있습니다.
데이터셋Template Wizard로 데이터셋을 생성합니다. delta / kafka / rest / object 서브타입을 선택.
코드Python 또는 SQL 코드 아티팩트를 생성합니다.
파이프라인컬렉션·폴더 컨텍스트를 잠근 상태로 파이프라인 에디터로 이동합니다.
지식지식 베이스를 생성합니다(이어서 문서 업로드/크롤 흐름).
대시보드빈 대시보드를 생성하고 빌더로 이동합니다.
에이전트에이전트 빌더로 이동합니다.

각 항목의 라벨은 동사가 아닌 명사구(예: "데이터셋", "파이프라인")로 표기됩니다. 이전 버전의 "데이터셋 만들기" 같은 중복 동사 표현은 정리되었습니다.

Quick Upload (드래그 앤 드롭 + 헤더 편집 가능한 미리보기)​

가장 빠른 추가 방법은 파일을 직접 드롭하는 것입니다.

  1. 좌측 트리에서 대상 컬렉션 또는 폴더를 선택합니다.
  2. 파일(CSV / Parquet / JSON / Python / SQL 등)을 우측 패널이나 트리 노드 위로 드래그해 놓습니다.
  3. 파일은 확장자 기준으로 자동 분류되어 데이터셋 또는 코드 자산으로 등록됩니다.
  4. CSV/JSON처럼 테이블형 파일은 헤더 편집 가능한 미리보기가 함께 열립니다. 컬럼명·타입을 즉시 수정할 수 있으며, AI 컬럼 명명 버튼으로 헤더가 모호하거나 비어 있을 때 자동 제안을 받을 수 있습니다.
  5. 이름 충돌이 있으면 경고와 AI 이름 제안이 함께 표시됩니다.
  6. 업로드 후에는 검토 단계가 추가되어, append/추가 대상 데이터셋의 기존 스키마와 충돌 여부를 확인한 뒤 적용할 수 있습니다.
스크린샷 TODO

Quick Upload에서 CSV 파일을 드롭한 직후의 미리보기 다이얼로그. 컬럼명 편집 입력과 AI로 컬럼명 생성 버튼이 보여야 합니다.

개별 파일 상한은 약 500MB입니다. 대규모 이관에는 ZIP Import / Export를 사용하세요.

기존 자산을 컬렉션에 추가하기 (Add Existing Items)​

이미 D.Hub에 등록된 자산을 컬렉션에 연결할 때 사용합니다. 이전 버전의 create vs add existing 두 갈래는 분리되어, 만들기는 위의 + 항목 추가 메뉴로, 기존 추가는 별도 다이얼로그로 진행합니다.

  1. 좌측 트리에서 대상 컬렉션을 선택합니다.
  2. 상세 패널의 기존 항목 추가 액션 또는 트리 노드 우클릭 메뉴를 클릭합니다.
  3. 기존 항목 추가 대화상자(공용 ItemPicker 셸)가 열립니다.

대화상자는 다음 기능을 제공합니다.

  • 유형 탭: All / Dataset / Code / Pipeline / Knowledge / Dashboard / Agent 탭으로 필터링합니다.
  • 검색: 이름이나 별칭으로 자산을 검색합니다. 별칭이 있으면 별칭 기준으로 매칭됩니다.
  • 기존 항목 숨기기: Hide existing items 체크박스로 이미 컬렉션에 포함된 자산을 숨깁니다.
  • 체크박스 다중 선택: 여러 자산을 한 번에 선택합니다. 이미 컬렉션에 포함된 자산을 선택하면 제거(remove) 동작으로 전환됩니다.
  • 파이프라인 에디터 이동: 파이프라인 탭에서 Open Pipeline Editor 버튼으로 에디터 화면으로 바로 이동할 수 있습니다.

하단의 선택 항목 영역에는 추가(to Add) / 제거(to Remove)할 아이템 수가 요약됩니다. 선택이 완료되면 변경 사항 적용 버튼으로 반영합니다.

트리에서 드래그 앤 드롭으로 이동​

Collection Tree v2는 6종 자원 모두 드래그 앤 드롭으로 이동 가능합니다.

스크린샷 TODO

트리에서 자원 leaf를 끌어 다른 폴더 위에 떨어뜨리는 중간 상태. drop indicator가 보여야 합니다.

  1. 자원 leaf 또는 폴더를 트리에서 끌어 대상 폴더/컬렉션 위로 가져갑니다.
  2. drop indicator가 표시되면 떨어뜨려 이동을 확정합니다.
  3. 권한 상한(Ceiling) 검증을 통과하면 즉시 이동되며, 트리·테이블이 동기화됩니다.

폴더 자체의 컬렉션 간 이동은 지원되지 않습니다(자원 단위만). 같은 컬렉션 내 다른 폴더로의 이동은 가능합니다.

Explorer 브라우즈 테이블에서 이동하기​

컬렉션/폴더를 선택하면 우측 패널의 폴더-as-page 테이블에서 파일 탐색기와 유사한 다중 선택·일괄 이동이 가능합니다.

  1. 테이블에서 이동할 자산의 체크박스를 선택합니다(여러 개 가능).
  2. 상단 일괄 액션 바에서 이동을 클릭합니다.
  3. 경로 피커(Move Path Picker) 다이얼로그에서 대상 컬렉션/폴더를 선택합니다.
  4. 권한 상한(Ceiling) 검증을 통과하면 이동이 실행됩니다.

경로 피커는 6종 모두를 지원하므로, 한 번의 선택으로 여러 타입 자원을 같은 폴더로 일괄 이동할 수 있습니다.

컨텍스트 메뉴로 이동​

  • 자산: 우클릭 → 이동
  • 폴더: 우클릭 → 이동(폴더 자체의 컬렉션 간 이동은 미지원; 같은 컬렉션 내 다른 폴더로만 이동 가능)

우클릭 만들기 (Create here)​

빈 공간이나 폴더를 우클릭하면 컨텍스트에 맞는 Create here 메뉴가 열립니다. 메뉴 항목은 위의 + 항목 추가 와 동일하지만, 만들어지는 자원은 우클릭한 위치를 부모로 사용합니다.

이름 변경 (alias)​

  • 컬렉션·폴더·자산의 컨텍스트 메뉴에서 이름 변경을 선택하면 별칭(alias) 을 편집할 수 있습니다.
  • 별칭은 사용자에게 보여 줄 표시 이름이며, 시스템 이름(name)은 식별자로 유지됩니다.
  • 브레드크럼과 목록에는 별칭이 우선 표기되고 별칭이 없으면 시스템 이름이 표시됩니다.

복제 (duplicate)​

  • 데이터셋·코드·파이프라인·지식·대시보드·에이전트 행을 우클릭 → 복제 를 선택하면 같은 컬렉션/폴더에 동일한 자산이 복제됩니다.
  • 복제된 자산은 원본 이름 뒤에 -copy 접미사가 붙은 새 별칭으로 생성되며, 생성 직후 선택 상태가 됩니다.

삭제​

  • 자산 삭제: 우클릭 → 삭제. 데이터셋처럼 오래 걸리는 정리 작업은 플로팅 패널에 비동기로 진행률이 표시됩니다(정리 패널 문서 참조).
  • 폴더 삭제: 폴더가 비어 있으면 즉시 삭제되고, 하위 자산이 있으면 확인 후 일괄 처리됩니다.
  • 컬렉션 삭제: 하위 자산 포함 여부를 선택할 수 있으며, 포함 시 Cleanup 패널에서 전체 진행 상태를 확인합니다. 부분 cascade 실패가 발생하면 어떤 자원이 실패했는지 알림으로 노출되고, 트리 상태는 정합성을 유지합니다.

참조 경고​

자산이 다른 파이프라인/지식/대시보드 등에서 참조 중이라면 삭제 전 경고가 표시되어 영향 범위를 확인할 수 있습니다.

다음 단계​