> ## Documentation Index > Fetch the complete documentation index at: https://manual.seahorse.dnotitia.ai/llms.txt > Use this file to discover all available pages before exploring further. > Storage 상세 — 문서 파이프라인, 파일 목록, Table Connections / Support Extension 팝업, 파일 업로드 # Storage detail # Storage 상세 & 파일 업로드 **경로**: Console → **Storage** → 목록에서 Storage 행 클릭 ## 헤더 | 요소 | 설명 | | ---------------------- | --------------------------------------------------------------------------- | | **← (뒤로)** | Storage 목록으로 이동 | | **제목 (Storage 이름)** | 예: `test` | | **ⓘ 정보 아이콘** | Storage 메타 툴팁 | | **Delete** (우측 상단, 빨강) | Storage 컨테이너 자체 삭제 → [Storage 삭제](/console/storage/storage-delete) 확인 다이얼로그 | ## 상단 요약 카드 (4 개) Image | 카드 | 내용 | 클릭 동작 | | --------------------- | -------------------------------------------------------------------------------------- | --------------------------------- | | **Document Pipeline** | `18 / 18 Completed` + 녹색 **진행률 바** — 업로드된 전체 문서 중 임베딩 완료된 개수 | — | | **Storage Size** | `8.89 MiB` (현재 Storage) + `668.53 MiB / 1000 GiB` (테넌트 전체 사용량 / 한도) | — | | **Table Connections** | 연결된 Table 이름 + 임베딩 모델 요약 (예: `test` / `qwen/qwen3-embedding-8b (#2) · BM25 sparse`) | **→ 클릭 시 "Table Connections" 팝업** | | **Support Extension** | 지원 확장자 총 개수 + 카테고리 요약 (예: `37` / `Documents 11 · Data 9 · Images 8 · Text & Markup 9`) | **→ 클릭 시 "Support Extension" 팝업** | Document Pipeline 의 진행률이 100 % 미만이면 스토리지가 아직 처리 중입니다. 진행률이 정체되고 `FAILED` 파일이 있다면 해당 파일만 삭제 후 재업로드하세요. ## 파일 목록 Image ### 상단 컨트롤 * **🏠 홈 아이콘** — 루트 경로로 이동 (브레드크럼) * **`18 documents` 뱃지** — 현재 Storage 의 총 파일 수 * **● Live** — 실시간 상태 반영 표시 (녹색 점) * **Refresh** — 목록 재조회 * **Upload** (우측 상단, 다크) — 업로드 팝업 열기 * **Search files…** — 파일명 실시간 필터 * **All** / **All extensions** 드롭다운 — 상태별 · 확장자별 필터 * 우측 `N items` — 현재 뷰에 표시된 개수 ### 목록 컬럼 | 컬럼 | 설명 | 예시 | | ----------------- | ------------------------------------ | ----------------------------------------------- | | (체크박스) | 다중 선택 | — | | **Name** | 파일명 또는 폴더명 (폴더는 📁 아이콘 + `✓N` 완료 뱃지) | `AI Expo✓17` / `api-gw-openapi-1-0-1-rc15.json` | | **File Size** | 파일 크기 (폴더는 `-`) | `57.89 KiB` | | **Status** | Storage 임베딩 결과 + 청크 수 뱃지 | `✓ Completed` + `54 chunks` | | **Last Modified** | 업로드·수정 시각 | `2026. 4. 21. 오후 7:36:26` | | **Actions** | ⬇ 다운로드 · 🗑 삭제 | — | **Status 값** | 값 | 의미 | | ------------------------ | ---------------------------------- | | `Completed` (녹색) | 임베딩 완료. 청크 수 뱃지 (`54 chunks` 등) 노출 | | `Processing` / `Pending` | 처리 중 · 대기 | | `Failed` (빨강) | 파싱·임베딩 실패 — 파일 삭제 후 재업로드로 재시도 | 폴더 행의 `✓N` 뱃지는 **하위 N 개 파일이 모두 Completed** 라는 뜻입니다. 하나라도 실패가 섞이면 해당 카운트가 줄어들거나 실패 표시가 함께 나타납니다. ## Table Connections 팝업 상단 **Table Connections** 카드를 클릭하면 연결된 Table 과 Inference Endpoint 상세를 팝업으로 확인합니다. ### Connected Table | 항목 | 예시 | | ---------------- | -------------------------------------------------- | | **Table Name** | `test` | | **Table UUID** | `2a500f64-8eab-4d2e-b3ab-1ea1e8890c88` | | **Status** | `● Success` / `Failed` / `Pending` | | **API URL** | `https://{uuid}.api.seahorse.dnotitia.ai` (복사 아이콘) | | **Table Schema** | 접기/펼치기 — Table 컬럼 스키마 보기 | ### Inference Endpoint **Dense** · **Sparse** 두 개 카드로 분리 표시. 각 카드 우측에 `● ACTIVE` 뱃지. | 항목 | Dense 예 | Sparse 예 | | ----------------- | ------------------------------ | ---------------- | | **Model** | `qwen/qwen3-embedding-8b (#2)` | `BM25 sparse` | | **Endpoint Type** | `text-embedding` | `text-embedding` | | **API Style** | `OpenAI` | `OpenAI` | | **Status** | `ACTIVE` | `ACTIVE` | Dense + Sparse 를 함께 사용하면 **하이브리드 검색** (Reciprocal Rank Fusion) 이 가능합니다. 검색 파라미터 튜닝: [Semantic Search → 고급 옵션](/console/semantic-search/before-search). ## Support Extension 팝업 상단 **Support Extension** 카드를 클릭하면 지원 확장자 전체 목록이 **4 개 카테고리 카드** 로 표시됩니다. **Supported File Extensions** · *File formats enabled for processing in this storage.* · **`37 total`** | 카테고리 | 개수 | 확장자 | | ----------------- | -- | ------------------------------------------------- | | **Documents** | 11 | `.doc.docx.hwp.hwpx.odg.odp.odt.pdf.ppt.pptx.rtf` | | **Data** | 9 | `.csv.json.ods.toml.tsv.xls.xlsx.yaml.yml` | | **Images** | 8 | `.bmp.gif.jpeg.jpg.png.tif.tiff.webp` | | **Text & Markup** | 9 | `.epub.htm.html.markdown.md.text.txt.xhtml.xml` | 지원되지 않는 확장자는 업로드가 거부되거나 Storage 임베딩 단계에서 skip 됩니다. 전역 확장자 정책은 관리자가 [Storage Settings](/internal/system-admin/settings/storage-settings) 에서 관리합니다. ## 파일 업로드 상단 **Upload** 버튼 클릭 → **Upload Files** 팝업. | 요소 | 설명 | | ---------------------------------- | --------------------------------- | | **Drop files here to upload** | 드래그 앤 드롭 영역 | | **Add Files** | 개별 파일 선택 (다중 가능) | | **Add Directory** | 폴더 통째 업로드 (하위 구조 유지) | | **Max 100 MiB per file** | 개별 파일 크기 제한 | | **경로 입력** (예: `documents/reports`) | Storage 내부 저장 경로 prefix — 비워두면 루트 | | **Cancel / Upload** | 취소 · 업로드 시작 | 업로드되면 스토리지가 자동으로 청킹·임베딩을 수행하여 **Completed** 상태로 전환되고, 상단 Document Pipeline 진행률에 반영됩니다. * **파일당 100 MiB 제한.** 큰 PDF/동영상은 분할 후 업로드하거나 별도 도구로 전처리하세요. * 테넌트 **Storage Size 한도**(예: 1000 GiB) 를 초과하면 업로드가 거부됩니다. * 지원 목록에 없는 확장자는 업로드가 거부됩니다. ## 파일 액션 (개별 파일) Storage **내부 파일** 작업. Storage 자체는 유지되고 해당 파일만 영향 받습니다. * **다운로드** — 행 ⬇ 아이콘 * **단일 삭제** — 행 🗑 아이콘 클릭 → 파일 + 관련 벡터 청크 제거 * **대량 삭제** — 체크박스 선택 후 상단 대량 삭제 실행 **스토리지 상태가 `Failed`** 인 경우, 해당 **파일만** 삭제 후 재업로드하면 다시 임베딩을 시도합니다. Storage 자체를 지울 필요는 없습니다. 파일 삭제 시 원본과 임베딩된 벡터 모두 **복구할 수 없습니다**. 중요 파일은 사전에 원본 백업하세요. ## Storage 자체 삭제 헤더 우측 상단의 **Delete** (빨강) 버튼은 **Storage 컨테이너 전체** 를 삭제합니다. 내부 모든 파일·임베딩·자동 생성 Table 이 **함께 제거** 되므로 파일 삭제와 구분해서 사용하세요. | 작업 | 버튼 위치 | 영향 범위 | | ----------------- | -------------------------------- | ----------------------------------------------- | | **파일 삭제** | 파일 행의 🗑 | 선택한 파일만 (+ 해당 파일의 벡터 청크) | | **Storage 자체 삭제** | 상세 헤더 **Delete** (빨강) 또는 목록 행 🗑 | Storage + 전체 파일 + 자동 생성 Table + 연결된 에이전트의 참조 끊김 | Storage 자체 삭제는 되돌릴 수 없고 연결된 에이전트·RAG 가 즉시 영향을 받습니다. 사전에 종속 에이전트를 확인하세요. 자세한 내용: [Storage 삭제](/console/storage/storage-delete) ## 관련 문서 * [Storage 목록](/console/storage/storage-list) * [Storage 생성](/console/storage/storage-create) * [Storage 삭제](/console/storage/storage-delete) * [Table 상세](/console/database/tables/table-detail) — 연결된 Table 의 스키마·인덱스 확인 * [Inference Endpoints (운영)](/internal/system-admin/settings/inference-endpoints) * [Semantic Search](/console/semantic-search)