---
updatedAt: 2026-07-02T02:11:12.000Z
agentTools:
  projectIndex: https://docs.datamaker.io/llms.txt
---

# 3-5. 데이터 익스포트

GT 데이터 익스포트 및 익스포트 현황 확인

<Callout icon="📘" theme="info">
  ###

  **데이터 익스포트(Data export) 의 개념**

  데이터를 특정 형식으로 변환하여 외부 시스템이나 저장소로 내보내는 과정으로, 시냅스에서는 사용자가 원하는 형식을 선택하여 내보낼 수 있습니다.
</Callout>

| 용어 및 기능 | 정의                                                       |
| ------- | -------------------------------------------------------- |
| 익스포트    | GT(Ground Truth) 데이터를 특정 형식으로 변환하여 외부 시스템이나 저장소로 내보내는 과정 |
| GT 데이터셋 | GT 데이터셋(GT Dataset)은 모델이 학습할 때 정답(참값)으로 사용하는 데이터들의 모음    |

<br />

### 데이터 익스포트

***

> 데이터 익스포트에서는 GT/작업/할당 작업 데이터셋을 선택하여 내보낼 수 있으며, 익스포트 진행 현황 및 목록을 확인할 수 있는 페이지입니다.
>
> 데이터 포맷에 맞춰 결과를 추출하고, 각 익스포트 작업의 상태를 모니터링할 수 있습니다.

| 용어 및 기능   | 정의                                                                                |
| --------- | --------------------------------------------------------------------------------- |
| 익스포트 플러그인 | 시냅스 내부의 데이터를 내보내는 과정에서 데이터 변환, 정리 등을 도와주는 플러그인                                    |
| 익스포트 스토리지 | 시냅스와 연동된 외부 스토리지 중 데이터를 익스포트할 때 저장할 저장소                                           |
| 에이전트      | 시냅스 내에서 구동되는 플러그인을 실행하는 주체로 에이전트는 여러 개의 노드로 구성,<br />각 노드는 CPU, 메모리, 디스크, GPU 등 임 |

<br />

① 상단 메뉴에서 <kbd>프로젝트</kbd> 탭을 클릭한 후, 데이터 익스포트하려는 프로젝트를 선택합니다.

<br />

② 좌측 사이드바의 <kbd>데이터셋</kbd> 탭에서 <kbd>데이터 익스포트</kbd> 탭을 선택하고, 우측 상단의 <kbd>익스포트</kbd> 버튼을 클릭합니다.

<Image src="https://files.readme.io/af494f90e383755f28ce0ca2aca4a6212582142076c7137392d778068a942766-image.png" align="center" border={true} />

<br />

③ **익스포트 플러그인 등록창**에서 <kbd>플러그인 선택</kbd> 버튼을 클릭하면, 팝업창이 열리며 **워크스페이스에 설치된 익스포트 플러그인 목록**이 표시됩니다.

<Image src="https://files.readme.io/c2e4592ba9dfacc7dd5d111b5e375da82e32e269252b0c968591c900e84bffe4-image.png" align="center" border={true} />

<br />

④ 사용하려는 플러그인을 선택한 후 <kbd>선택 완료</kbd> 버튼을 클릭하면 등록이 완료됩니다.

선택한 플러그인을 변경하고 싶을 경우, <kbd>플러그인 변경</kbd> 버튼을 클릭하면 이전과 동일한 플러그인 목록이 다시 표시되어 다른 플러그인을 선택할 수 있습니다.

<Image src="https://files.readme.io/8351dc7ae58e0558f00c607596559ca594201861930387a8a3a22eeca76569af-image.png" align="center" width="500px" caption="익스포트 플러그인 기본 6종" />

<Callout icon="🚧" theme="warning">
  ###

  **익스포트 플러그인 안내**

  플랫폼 초기 납품 시, 기본 이미지 익스포트 플러그인 6종이 워크스페이스에 탑재되어 제공합니다.

  프로젝트에 맞는 별도의 익스포트 플러그인이 필요한 경우, 커스텀 요청이 가능합니다.

  자세한 사항은 데이터메이커 테크서포트에 문의해주세요.
</Callout>

<br />

⑤ 익스포트 생성창에서 익스포트 **기본 정보**를 입력하고 우측 상단의 <kbd>다음 단계</kbd> 버튼을 클릭합니다.

<Image src="https://files.readme.io/26be347532032de3db331f00d3045e0be395034bcbba091510f23b2b8a056e73-image.png" align="center" border={true} />

* **익스포트 이름** : 익스포트의 이름을 기입합니다. (최대 50자 입력 가능)

  (\* 익스포트 이름은 익스포트되는 파일의 **폴더명**으로 사용됩니다.)

* **설명** : 익스포트에 대한 설명을 기입합니다. (최대 200자 입력 가능)

* **에이전트** : 익스포트를 실행할 에이전트를 선택합니다.

  <kbd>더보기</kbd> 버튼을 클릭하면 선택한 에이전트의 상세 정보를 확인할 수 있습니다.

  (※ 워크스페이스에 설치된 에이전트 목록만 표시됩니다.)

<Callout icon="❗️" theme="danger">
  ###

  **연동하고자 하는 에이전트가 안보여요!**

  에이전트는 인프라 > 에이전트 > 에이전트 연동을 통해 가능합니다.

  👉🏻 [5-1. 에이전트 연동](doc:에이전트)을 참고해주세요.
</Callout>

* **익스포트 스토리지** : 현재 활성화된 스토리지 목록이 표시되며, 사용자는 원하는  스토리지를 선택한 후, 익스포트할 폴더를 선택합니다.

<Callout icon="📘" theme="info">
  ###

  **스토리지(저장소)를 연동하고 싶어요 !**

  스토리지 연동이 필요한 경우, 데이터메이커 담당자를 통해 연동을 요청해주세요.

  저장소 설정은 내부 확인 후 순차적으로 지원해드립니다.
</Callout>

<br />

⑥ 익스포트를 진행할 **대상 데이터**를 선택하고, 우측 상단의 <kbd>생성</kbd> 버튼을 클릭합니다.

\*익스포트 가능한 데이터는 `GT 데이터셋`, `작업 데이터`, `할당작업 데이터` **3가지**입니다.

<Image src="https://files.readme.io/c39b35f6161e085b72bcec2d214174d2e2e49dd57efd5de1a00548a2c823bb17-image.png" align="center" border={true} />

<br />

#### a. GT 데이터셋

GT 데이터셋으로 생성된 버전을 선택할 수 있으며, 선택한 버전에 해당하는 작업 목록이 함께 표시됩니다.<br />이 때, 개별 작업 선택은 불가능하며 버전 전체 단위로만 익스포트가 가능합니다.

<Image src="https://files.readme.io/cf559f034744915e836986127bccbd0cb9a0bf5748abba0d8c9c903c129c3333-image.png" align="center" border={true} />

<Image src="https://files.readme.io/5eb5eb4a715d15ed907a9a5b74f50b19a3571a57ff0098b5b069a5aa4fba46a6-image.png" align="center" border={true} />

<br />

#### b. 작업 데이터

해당 프로젝트 내에 있는 전체 작업 목록이 노출되며, 개별 작업 단위로 선택하여 익스포트할 수 있습니다.

<Image src="https://files.readme.io/41cf47f65cdde791e1216b10a24f8a9dd3929556065dc8c461e7c559baac43eb-image.png" align="center" border={true} />

<br />

#### c. 할당작업 데이터

해당 프로젝트 내에 있는 전체 할당작업 목록이 노출되며, 개별 할당 작업 단위로 선택하여 익스포트할 수 있습니다.

<Image src="https://files.readme.io/0e6a84a518153538ce749ce36842725523e498c1480b47a7b960752f48b4b559-image.png" align="center" border={true} />

<Callout icon="⬜" theme="info">
  ###

  **'원본데이터 포함 옵션' 안내**

  익스포트 시 원본 데이터를 함께 포함할지 여부를 설정하는 항목입니다. 원본 데이터를 포함하여 익스포트를 진행할 경우, 처리 시간이 더 오래 걸릴 수 있습니다.
</Callout>

<Callout icon="❗️" theme="danger">
  ###

  **익스포트할 데이터셋이 없어요 !**

  현재 워크스페이스에는 아래 항목 중 하나라도 존재하지 않으면 익스포트를 진행할 수 없습니다. 데이터 익스포트를 위해서는 다음 중 하나 이상의 데이터셋이 반드시 필요합니다.

  - GT 데이터셋
  - 작업 데이터
  - 할당작업 데이터
</Callout>

<Callout icon="👍" theme="success">
  ###

  **익스포트 취소** 기능 안내

  익스포트 진행 중에는 우측 상단에 \[익스포트 취소] 버튼이 표시됩니다. 해당 버튼을 클릭하면 현재 진행 중인 익스포트 작업이 즉시 중단됩니다. (단, 취소 시점 이전까지 이미 처리된 내용은 반영된 상태로 유지됩니다.)
</Callout>

<br />

### **데이터 익스포트 현황**

***

> 익스포트한 데이터들의 진행 상태 및 관련 메타정보를 한눈에 파악할 수 있는 페이지입니다.

<br />

① 상단 메뉴에서 <kbd>프로젝트</kbd> 탭을 클릭한 후, **익스포트 현황을 보려는 프로젝트**를 선택합니다.

<br />

② 좌측 사이드바의 <kbd>데이터셋</kbd> 탭에서 <kbd>데이터 익스포트</kbd> 탭을 클릭하면, 해당 프로젝트에서 진행된 익스포트 현황 정보 목록을 확인할 수 있습니다.

<Image src="https://files.readme.io/a7db1f5b7125794489dc8313f1caaf2775a044e50dd4172d54b380f375eec110-image.png" align="center" border={true} />

<Callout icon="🧐" theme="info">
  ###

  **익스포트 현황 살펴보기**

  - **대기/성공/실패** : 익스포트 과정에서의 처리 상태별 수량을 의미합니다.

    `대기` : `익스포트 처리가 아직 진행 중인 데이터의 수`

    `성공` : `정상적으로 익스포트가 완료된 데이터의 수`

    `실패` : `조건 미충족 등으로 인해 익스포트되지 않은 데이터의 수`
  - **상태** : '상태'는 데이터 수량이 아닌, 익스포트의 '진행 과정'을 기준으로 표시됩니다.

  `✅완료`<br />익스포트 과정이 정상적으로 종료되었음을 의미합니다.
  단, 일부 데이터는 조건 미충족 등의 사유로 익스포트되지 않았을 수 있습니다.

  `⛔실패`<br />익스포트 도중에 오류 또는 에이전트 문제 등으로 인해 중단된 상태를 의미합니다.
  이 경우에도 일부 데이터는 익스포트에 성공했을 수 있습니다.

  `🕛대기` 아직 데이터 등록 작업이 시작되지 않았거나, 처리 대기 상태를 의미합니다.

  `▶️진행 중` 현재 데이터 등록 과정이 실행되고 있으며, 순차적으로 처리되고 있는 상태를 의미합니다.

  `🟡중지` 익스포트가 진행 중일 때 사용자가 취소하여 중단된 상태를 의미합니다.
</Callout>

<Callout icon="👍" theme="success">
  ###

  **필터링 기능을 활용하세요!**

  - 상태 : 익스포트 작업의 상태별 필터링할 수 있으며 대기, 진행 중, 완료, 중지, 실패 상태로 구분됩니다.
  - 담당자 : 데이터 익스포트를 수행한 담당자 기준으로 현황을 확인할 수 있습니다.
  - 시작일시 : 익스포트가 시작된 날짜를 기준으로 작업 현황을 확인할 수 있습니다.
</Callout>

<br />

③ **원하는 익스포트 ‘이름’을 클릭하면,** 해당 익스포트의 **현황 상세보기 페이지**로 이동합니다.

해당 페이지에서는 다음 정보를 확인할 수 있습니다.

<Image src="https://files.readme.io/6171f73d3362b1b72c63d0217fcad19b06eb6f24183b5cf5b1ad215267880bf2-image.png" align="center" border={true} />

<Callout icon="🧐" theme="info">
  ###

  **익스포트 대시보드 살펴보기**

  - **진행률** : 익스포트 과정 진행률(%)

  - **소요시간** : 익스포트 과정 소요시간

  - **대기/성공/실패** : 익스포트 과정에서의 처리 상태별 수량을 의미합니다.

    `대기` : `익스포트 처리가 아직 진행 중인 데이터의 수`

    `성공` : `정상적으로 익스포트가 완료된 데이터의 수`

    `실패` : `조건 미충족 등으로 인해 익스포트되지 않은 데이터의 수`
</Callout>

* **익스포트 기본 정보 :** 익스포트 이름, 익스포트 설명, 익스포트 ID, 익스포트 담당자, 익스포트 일시, 익스포트 상태, 플러그인 정보, 총 익스포트 파일 수, 익스포트 위치 등의 정보를 확인할 수 있습니다.
* **익스포트 진행률** : 전체 진행률과 소요 시간을 확인할 수 있습니다.
* **메세지 로그(Message Log)** : 우측 패널에서 익스포트 실행 과정 및 오류 내용을 확인할 수 있습니다.

<br />

#### 상세 로그 확인하기

익스포트 작업이 끝난 후, 어떤 항목이 성공하고 실패했는지 항목 단위로 상세 로그를 확인할 수 있습니다.

<Image src="https://files.readme.io/74cd888915ee52c9a3a4fabca1c7880cacf7684473e3c5a4816065db32470edb-image.png" align="center" border={true} />

<Image src="https://files.readme.io/964abf1d4ea8a1e882ad382cac13bad6125d2e0ba4029ebfa465fb6dccd23571-image.png" align="center" />

<Callout icon="🤔" theme="info">
  ###

  **상세 로그로 무엇을 알 수 있나요?**

  기존에는 대량 데이터를 임포트·익스포트할 때 일부 항목이 실패해도 어떤 항목이 왜 실패했는지 확인하기 어려웠습니다.

  상세 로그를 통해 항목별 성공·실패 여부와 실패 사유를 직접 확인할 수 있어, 전체 데이터를 다시 업로드하지 않고 실패한 항목만 선별해 처리할 수 있습니다.
</Callout>

> 임포트·익스포트 완료 후 처리 결과를 항목 단위로 확인합니다.

① 임포트 또는 익스포트 작업이 완료되면 결과 화면에서 <kbd>상세 로그</kbd>를 확인합니다.

② 각 항목의 성공·실패 여부와 실패 사유를 확인합니다.

* **성공·실패 여부** : 항목 단위로 처리 결과를 표시합니다.
* **실패 사유** : 실패한 항목에 대해 실패 원인을 함께 표시합니다.

<br />

#### 로그 다운로드

① <kbd>상세 로그 다운로드</kbd> 버튼을 클릭하여 결과 로그를 엑셀 파일로 저장합니다.

<Image src="https://files.readme.io/598ee1f8112c2fdf4719660384200313b528ce1d7420cb36fa8d64508df8232b-image.png" align="center" border={true} />

<Callout icon="👍" theme="success">
  ###

  **대량 데이터도 다운로드할 수 있습니다**

  5만 건 이상의 대량 데이터 처리 결과도 엑셀 파일로 정상적으로 다운로드할 수 있습니다.
</Callout>

<br />