2-2. 데이터 임포트*

새로 생성한 컬렉션에 데이터셋을 업로드하기 위한 방법입니다.

📘

데이터 임포트(Data import)란?

시냅스와 연결된 스토리지에 있는 데이터를 시냅스로 가져오는 기능입니다. 데이터메이커 시냅스의 컬렉션에 데이터들을 업로드하고, 프로젝트를 연결하여 사용합니다.

① 상단 메뉴에서 카탈로그 탭을 클릭한 후, 데이터 임포트가 필요한 컬렉션 카드를 선택합니다.

② 좌측 메뉴에서 임포트 현황 탭을 선택하고 우측 상단의 임포트 버튼을 클릭합니다.

임포트 스토리지 선택

---

① 임포트 버튼을 클릭하면, 팝업창이 열리며 임포트 위치 유형에 따른 스토리지를 선택을 할 수 있습니다. 스토리지 드롭박스를 클릭하면 워크스페이스에 연동한 스토리지 목록을 볼 수 있습니다.

② 스토리지를 선택한 후 다음 버튼을 클릭합니다.

임포트 플러그인 선택

---

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

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

③ 우측 상단 다음 단계버튼을 클릭합니다. (※ 플러그인을 선택하지 않으면 다음 단계로 넘어갈 수 없습니다.)

선택한 플러그인을 변경하고 싶을 경우, 플러그인 변경 버튼을 클릭하면 이전과 동일한 플러그인 목록이 다시 표시되어 다른 플러그인을 선택할 수 있습니다. (※ 워크스페이스에 기본 임포트 플러그인은 초기 납품 시 설치해드립니다.)

👍

그룹이름은 무엇인가요?

그룹 이름은 임포트할 데이터를 그룹으로 구분하고자 할 때 원하는 그룹명을 지정하여 사용할 수 있습니다.

✋

이전 단계로 돌아가고 싶어요!

지나온 단계의 입력한 정보를 수정하고 싶은 경우에는, 상단의 단계 제목을 클릭하여 이전 단계로 돌아갈 수 있습니다.이전 단계의 정보 수정을 완료하면 반드시 '다음 단계>' 버튼을 클릭해주세요!

기본 정보 입력

---

① 임포트 생성창에서 임포트 기본 정보를 입력합니다.

임포트 이름

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

설명

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

에이전트

임포트를 실행할 에이전트를 선택합니다.더보기 버튼을 클릭하면 선택한 에이전트의 상세 정보를 확인할 수 있습니다. (※ 워크스페이스에 설치된 에이전트 목록만 표시됩니다.)

임포트 경로 설정

아래 설명은 시냅스에서 기본 제공하는 Import 플러그인이 적용된 경우에만 해당됩니다.

• On-Off : 단일 경로 모드 On-Off 기능입니다. 단일 경로 모드로 임포트를 원하는 경우 활성화하여 활용할 수 있습니다.
• 폴더 선택 : 폴더 선택 클릭 시 임포트할 폴더 선택 팝업창이 열립니다. 최종 임포트할 폴더를 찾아 선택해주세요.

📘

단일 경로 업로드 모드 안내

해당 버튼을 클릭하면 임포트 경로를 단일 경로로 업로드하는 모드(방식)로 변경됩니다. ‘단일 경로’ 모드는 임포트하려는 폴더의 실제 구조가 데이터 유닛이 요구하는 구조와 동일해야 합니다. 스토리지에서 폴더 생성 및 수정이 비교적 수월한 환경이라면 해당 방식을 활용하여 정확하고 일관된 구조로 안정적으로 임포트 할 수 있습니다.

폴더 선택 시 주의사항

하단에 안내된 데이터 유닛 구조와 동일한 형태로 폴더를 준비한 뒤, 해당 폴더 구조를 포괄한 상위 폴더를 선택해야 합니다. (폴더 경로를 반드시 확인해주셔야 합니다.)

※ 하위 폴더에 다른 폴더 구조가 포함되어 있더라도 해당 데이터 유닛 구조에 해당하는 폴더만 인식되어 임포트 됩니다.

• 단일 데이터 구조 폴더 선택 방법 : 예시) 물류창고 이미지 컬렉션

  

• 복합 데이터 구조 폴더 선택 방법 : 예시) PCD 자율주행 이미지 컬렉션

  

👍

스토리지 폴더 선택 시 검색기능 안내

임포트/익스포트 시 파일 선택 창에서 우측 검색란을 통해 폴더이름을 입력하여 빠르게 검색할 수 있습니다. 단, 현재 보고 있는 디렉터리 내 폴더만 검색이 되며 그 하위폴더는 검색되지 않습니다. (기본 정렬 기준은 이름 오름차순 정렬) 필요한 폴더를 더욱 빠르고 편리하게 찾아보세요 !

• 데이터 유닛 메타 : 원하는 경우, 데이터 유닛 메타 파일을 업로드합니다. (xslx 형식 지원)

📘

데이터 유닛 메타는 무엇인가요 ?

임포트된 데이터의 정보는 아래 2가지 유형으로 나뉘어 관리됩니다.

1. 파일 정보(File Information): 데이터 유닛 구조 설정에 따라 시스템이 자동으로 생성하는 파일단위 정보입니다. 예시로는 파일명, 파일경로, 프레임 수, 해상도 등 파일 자체가 보유하고 있는 속성들이 여기에 해당됩니다.
2. 데이터 유닛 메타 정보(Data Unit Meta Information) : 데이터 임포트 과정에서 사용자가 직접 항목명을 정의하여 구성하는 추가 정보입니다. 프로젝트 목적에 따라 필요한 메타 필드를 자유롭게 구성할 수 있습니다. 예시로는 카메라ID, 촬영 환경, 상황 설명 등 사용자가 프로젝트 목적에 맞게 커스터마이징할 수 있는 정보이며 데이터 관리를 위한 중요한 기준값으로 활용할 수 있습니다.

• 템플릿 다운로드 : 해당 버튼을 클릭하여 템플릿을 다운로드합니다. 다운로드한 엑셀파일은 다음과 같은 형식으로 사용됩니다.

  
  • A열(첫번째 컬럼) : 파일명 – 임포트할 대상의 파일 이름을 입력합니다. 확장자는 제외한 파일 이름을 입력합니다.
  • B열부터 : 사용자 정의 메타 항목 – 필요한 항목을 직접 추가 입력합니다.

• 파일 선택 : 파일 선택 버튼을 클릭하여 사용자가 만든 메타정보 엑셀파일을 업로드합니다.

임포트 누락 / 미처리 항목 안내

⚠️

임포트가 정상적으로 완료된 경우에도, 일부 데이터가 조건에 맞지 않아 건너뛰어지거나 처리되지 않을 수 있습니다. 아래와 같은 상황이 대표적이니 반드시 확인해주세요.

첫째, 데이터 유닛 구조 불일치

선택한 폴더 구조가 사전에 정의한 데이터 유닛 구조와 정확히 일치하지 않는 경우, 해당 항목은 임포트되지 않습니다. 반드시 임포트 전에, 선택한 폴더 구조가 미리 정의한 데이터 유닛 구조와 이름이 정확히 일치하는지 다시 한번 확인해주세요.

💡Tip : 임포트 전에 데이터 유닛 구조 예시와 실제 폴더 구성을 비교하여 일치 여부를 확인해 주세요.

둘째, 임포트 불가능한 파일 포맷, 폴더 포함

선택한 폴더 안에 지원되지 않는 파일 포맷이나, 데이터 유닛과 관련 없는 불필요한 폴더가 있는 경우, 해당 항목은 자동으로 제외되며 임포트되지 않습니다. 반드시 임포트할 데이터가 지원 포맷 및 구조 기준에 부합하는지 사전에 점검해주세요.

💡Tip : 임포트 전에 폴더 내 파일의 포맷을 점검하여, 지원되지 않는 포맷이 있는지 꼭 확인해 주세요.

데이터 타입	지원 파일 포맷
이미지	JPG, JPEG, PNG
텍스트	TXT, HTML
비디오	MP4
오디오	MP3, WAV
PCD	PCD
DATA	json, xml, bin, fbx

데이터 유닛 구조

📘

데이터 유닛 구조란 ?

데이터 임포트 시 하나의 데이터 단위를 구성하는 폴더와 파일 구조의 기준을 정의한 것입니다.

선택한 임포트 스토리지 내 폴더 구조가 데이터 유닛 구조와 어떻게 매칭되는지 미리 확인할 수 있습니다. 도움말 아이콘 [❕]을 클릭하면 관련된 설명을 볼 수 있습니다.

② 우측 상단의 생성버튼을 클릭하여 임포트를 시작합니다. 임포트가 시작되면, 임포트 현황페이지를 확인하실 수 있습니다.

임포트 현황

---

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

① 컬렉션 내의 좌측 메뉴에서 임포트 현황 탭을 클릭하면, 해당 컬렉션에서 진행했던 임포트 현황 정보 목록을 확인할 수 있습니다.

🧐

임포트 현황 살펴보기

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

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

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

  실패 : 조건 미충족 등으로 인해 임포트되지 않은 데이터의 수

• 상태 : '상태'는 데이터 수량이 아닌, 임포트의 '진행 과정'을 기준으로 표시됩니다.

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

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

🕛대기
아직 임포트 작업이 시작되지 않았거나, 처리 대기 상태를 의미합니다.

▶️진행중
현재 임포트가 실행되고 있으며, 순차적으로 처리되고 있는 상태를 의미합니다.

👍

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

필터 : 설정한 조건에 부합하는 임포트 현황을 필터링합니다.

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

👍

임포트 취소기능 안내

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

② 원하는 임포트 현황 확인을 위해 임포트 ‘이름’을 클릭하면, 해당 임포트 상세 현황을 확인할 수 있습니다.

상세 현황 페이지에서는 다음 정보를 확인할 수 있습니다.

🧐

임포트 대시보드 살펴보기

• 진행률 : 임포트 과정 진행률(%)

• 소요시간 : 임포트 과정 소요시간

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

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

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

  실패 : 조건 미충족 등으로 인해 임포트되지 않은 데이터의 수

• 임포트 기본 정보 : 임포트 이름, 임포트 설명, 임포트 ID, 임포트 담당자, 임포트 일시, 임포트 상태, 플러그인 정보, 총 임포트 파일 수 및 전체 용량 등 기본 정보가 제공됩니다.
• 임포트 파일에 대한 정보 : 필터(상태), 검색, 시간 기준 정렬 기능을 통해 개별 파일의 임포트 결과를 확인할 수 있습니다.
• 메세지 로그(Message Log) : 우측 패널에서 실행 로그가 표시되며, 임포트 실행 과정 및 오류 내용을 확인할 수 있습니다.