# 데이터 가져오기

> 이 가이드는 데이터 관리 화면의 전체 기능을 설명하는 문서가 아닙니다. 라벨링 작업을 시작하기 위해 필수적인 **원천 데이터 가져오기(Import)** 과정만을 다룹니다. 데이터 내보내기(Export) 기능은 라벨링 완료 후 동일한 화면에서 수행할 수 있으며, 별도 가이드(데이터 내보내기 가이드, 추가예정)를 참고하세요.

### 데이터 가져오기란

데이터 가져오기는 워크플로우에서 에픽 생성 시 지정한 원천데이터 디렉토리 경로에 있는 파일을 Label-it 시스템으로 Import하는 작업입니다. 이 과정을 완료해야 라벨러가 라벨링 스튜디오에서 실제 데이터를 확인하고 작업을 시작할 수 있습니다.

***

### 데이터 관리 화면 진입

1. 상단 탭 메뉴에서 "데이터 관리"를 클릭합니다.

<figure><img src="/files/TZfdUx72repzIYOzo0RD" alt=""><figcaption></figcaption></figure>

화면 상단에 다음 요약 정보가 표시됩니다.

| 항목                | 설명                                 |
| ----------------- | ---------------------------------- |
| **목표 데이터 업로드 수량** | 프로젝트 관리에서 설정한 목표량 대비 현재 Import된 수량 |
| **업로드 실패 건수**     | Import 과정에서 실패한 파일 수               |
| **내보낼 수 있는 데이터**  | 라벨링이 완료되어 Export 가능한 데이터 수         |
| **삭제된 데이터**       | 삭제 처리된 데이터 수                       |

***

### 원천 데이터 가져오기

다음 화면에서 원천 데이터를 시스템으로 가져오세요.

1. 우측 상단 "가져오기" 버튼을 클릭합니다.
2. "원천데이터 가져오기" 모달 팝업이 표시됩니다.

<figure><img src="/files/PR5tvZXHlxXQ04JEEyaO" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/QTwtnCMOWTFbIqxyLkeY" alt=""><figcaption></figcaption></figure>

3. "에픽 선택하기" 영역에서 데이터를 가져올 에픽을 검색하거나 목록에서 확인합니다.

* 검색 필드에 에픽 이름을 입력하여 필터링할 수 있습니다.
* "전체 선택" 링크를 클릭하면 모든 에픽을 한 번에 선택합니다.
* "선택 초기화" 링크를 클릭하면 선택을 모두 해제합니다.

4. 에픽 목록에서 가져올 에픽의 "선택" 컬럼을 클릭하여 체크합니다.

* 선택된 에픽은 상단에 파란색 태그로 표시됩니다.
* 복수의 에픽을 동시에 선택할 수 있습니다.

5. 하단의 "가져오기" 버튼을 클릭합니다.

* "취소" 버튼을 클릭하면 작업을 취소하고 모달을 닫습니다.<br>

***

### 가져오기 결과 확인

가져오기를 실행하면 다음 두 가지 방법으로 진행 상태를 확인할 수 있습니다.

<figure><img src="/files/5Nt1GxxchESFj2lpO90X" alt=""><figcaption></figcaption></figure>

1. **데이터 로그**에서 가져오기 이력을 확인합니다.
   * "공유 일시" 컬럼에 실행 시간이 표시됩니다.
   * "제목" 컬럼에 가져오기 결과 메시지가 표시됩니다.
   * 예시: "452 수량의 데이터가 도심\_주간\_배치01에 가져오기 되었습니다."
2. **상단 요약 카드**에서 "업로드 실패 건수"를 확인합니다.
   * 건수를 클릭하면 실패 상세 내역을 조회할 수 있습니다.
3. 화면 우측 하단의 **실시간 알림 아이콘**(🔄)을 통해서도 진행 상태를 확인할 수 있습니다.

***

### 주의사항

> ⚠️ **주의**: 데이터 가져오기는 에픽 생성 시 설정한 "원천데이터 디렉토리" 경로에 존재하는 파일을 대상으로 수행됩니다. 해당 경로에 파일이 없거나 스토리지 연결에 문제가 있으면 가져오기가 실패합니다. 사전에 \[프로젝트 설정 - 스토리지]와 \[워크플로우 - 에픽 생성] 설정을 확인하세요.

> ⚠️ **주의**: 프로젝트 설정 - 데이터에서 지정한 "원천 데이터 지원 형식"에 해당하지 않는 파일은 가져오기 시 자동으로 제외되며, 업로드 실패 건수에 포함됩니다.

> 💡 **팁**: 대량의 데이터를 가져올 경우 시간이 소요될 수 있습니다. 데이터 로그와 우측 하단 실시간 알림을 통해 완료 시점을 확인하세요. 가져오기 중에도 다른 화면으로 이동하여 작업할 수 있습니다.

***

### 다음 단계

데이터 가져오기를 완료했다면, \[[프로젝트설정 - 일반](https://app.gitbook.com/o/S5k6Laufss4bUJb5Bn2T/s/AYU98CRV9OvBC6QHlOFe/~/edit/~/changes/1/pm/undefined-1/undefined/undefined)]에서 작업 상태를 In Progress로 변경 후 태스크 담당자에게 작업 시작을 안내하세요. 태스크 설정 작업은 \[[태스크 매니저(TM) 가이드 - 태스크 초기 설정](https://app.gitbook.com/o/S5k6Laufss4bUJb5Bn2T/s/AYU98CRV9OvBC6QHlOFe/~/edit/~/changes/1/tm/undefined-1)]에서 확인할 수 있습니다.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.label-it.ai/pm/undefined-1/undefined-2.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.