> For the complete documentation index, see [llms.txt](https://help.xpert.lever.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.xpert.lever.me/data_center/rd/upload_mgmt-1/undefined-1.md).

# 파일 업로드 방식

파일 업로드 방식은 로컬에 저장된 데이터 파일을 직접 Xpert 데이터센터로 업로드하는 기능입니다. 다양한 파일 형식을 지원합니다.

## 1단계: 기본 정보 입력 <a href="#id-1-.1" id="id-1-.1"></a>

<figure><img src="/files/sSPSu8jvIJgLq5duQdKx" alt="" width="563"><figcaption></figcaption></figure>

### 1. 데이터 이름 입력 <a href="#id-1" id="id-1"></a>

업로드할 데이터를 식별할 수 있는 고유한 이름을 입력합니다.

데이터 목록 탭의 데이터 이름 컬럼에 나타나는 항목입니다.

### 2. 데이터 유형 선택 <a href="#id-1" id="id-1"></a>

업로드할 데이터의 성격에 따라 데이터센터에서 지원하는 아래 4가지 유형 중 하나를 선택합니다.

<table data-header-hidden><thead><tr><th width="179.4000244140625"></th><th></th><th></th></tr></thead><tbody><tr><td>유형</td><td>설명</td><td>데이터센터 처리 방식</td></tr><tr><td><strong>매체</strong></td><td>매핑의 기준이 되는 데이터</td><td>매체로 취급</td></tr><tr><td><strong>트래커</strong></td><td>매핑의 재료가 되는 데이터</td><td>트래커로 취급</td></tr><tr><td><strong>인덱스</strong></td><td>매핑의 재료가 되는 데이터</td><td>인덱스로 취급</td></tr><tr><td><strong>호스팅</strong></td><td>매핑의 재료가 되는 데이터</td><td>트래커 및 인덱스로 취급</td></tr></tbody></table>

## 2단계: 파일 업로드 <a href="#id-2" id="id-2"></a>

<figure><img src="/files/PpuTGnzx9x14myvo4QQP" alt="" width="563"><figcaption></figcaption></figure>

### 3. 파일 선택 및 업로드 <a href="#undefined" id="undefined"></a>

파일 업로드 유형을 선택한 후, `파일선택`을 클릭해 업로드할 파일을 선택합니다.

**지원 파일 형식 및 제한사항**

| 파일 형식           | 확장자   | 최대 용량 | 추가 설정        |
| --------------- | ----- | ----- | ------------ |
| **CSV**         | .csv  | 50MB  | 인코딩 형식 선택 필요 |
| **Excel (신버전)** | .xlsx | 50MB  | 시트 선택 필요     |
| **Excel (구버전)** | .xls  | 50MB  | 시트 선택 필요     |

### 4. 파일 형식별 세부 설정 <a href="#id-3" id="id-3"></a>

**CSV 파일 설정**

CSV 파일 업로드 시 다음 중 하나의 인코딩 형식을 선택해야 합니다.

* **UTF-8**: 다국어 지원, 가장 일반적인 형식
* **UTF-8 BOM**: UTF-8에 BOM(Byte Order Mark) 추가
* **EUC-KR (CP949)**: 한국어 전용 인코딩
* **ISO-8859-1**: 서유럽 언어 지원
* **ASCII**: 영문 및 기본 문자만 지원

<figure><img src="/files/elP2kulh2kD70Y4ZV8ei" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}

* 한글이 포함된 경우: UTF-8 또는 EUC-KR 형식을 권장드립니다.
* 특수문자가 많은 경우: UTF-8 형식을 권장드립니다.
* 파일이 깨져 보이는 경우: 다른 인코딩 형식으로 재시도해주세요.
  {% endhint %}

**Excel 파일 설정 (.xlsx, .xls)**

Excel 파일을 업로드한 경우, 파일 내 모든 시트 목록이 드롭다운으로 표시됩니다. 해당 목록에서 업로드하고자 하는 특정 시트를 선택할 수 있습니다.

<figure><img src="/files/TeNZtIkPy6NUtp2N52IS" alt="" width="563"><figcaption></figcaption></figure>

## 3단계: 업로드 검증 <a href="#id-4" id="id-4"></a>

<figure><img src="/files/ioCbGr93Tweo1OKc2MTg" alt="" width="563"><figcaption></figcaption></figure>

### 5. 업로드 데이터 확인 버튼 활성화 <a href="#id-1" id="id-1"></a>

파일선택 및 세부 설정을 완료하면 최하단의 **업로드 데이터 확인** 버튼이 활성화됩니다.

**상태 표시**

* **파란 체크 표시 있음**: 업로드 준비가 완료된 상태를 의미합니다.
* **파란 체크 표시 없음**: 데이터에 문제가 발견된 경우로, 확인이 필요합니다.

**완료 버튼 제한**

파란 체크 표시가 없는 상태에서 데이터 업로드 완료를 시도할 경우 "완료할 수 없습니다"라는 메시지가 표시됩니다.

이 때에는 반드시 **업로드 데이터 확인** 버튼을 클릭해 문제를 해결해야 업로드를 완료할 수 있습니다.

## 4단계: 데이터 형식 검증 및 설정 <a href="#id-5" id="id-5"></a>

<figure><img src="/files/1WbY9tsZWHd6XFalBQGa" alt=""><figcaption></figcaption></figure>

### 6. 업로드 데이터 확인 팝업 <a href="#id-1" id="id-1"></a>

업로드하려는 데이터의 컬럼과 데이터 타입을 확인할 수 있으며, 데이터 타입을 지정할 수 있습니다.

**컬럼 분석**

* **컬럼 헤더**: 구글 시트의 실제 컬럼명이 표시됩니다.
* **데이터 타입**: Xpert에서 각 컬럼에 대해 자동으로 인식한 데이터 유형이 표시됩니다.

**지원 데이터 타입**

<table data-header-hidden><thead><tr><th width="213"></th><th></th><th></th></tr></thead><tbody><tr><td>데이터 타입</td><td>설명</td><td>변환 옵션</td></tr><tr><td><strong>일자</strong></td><td>날짜 형식 데이터<br>(YYYY-MM-DD 형식 필수)</td><td>기준 일자로 지정 가능</td></tr><tr><td><strong>일시</strong></td><td>날짜와 시간이 포함된 데이터</td><td>변환 불가</td></tr><tr><td><strong>문자</strong></td><td>텍스트 형식 데이터</td><td>변환 불가</td></tr><tr><td><strong>숫자</strong></td><td>숫자 형식 데이터</td><td>문자로 변환 가능</td></tr><tr><td><strong>비어있음</strong></td><td>빈 값이 포함된 컬럼</td><td>문자로 변환 가능</td></tr></tbody></table>

**데이터 타입 변환**

* **숫자 → 문자**: 숫자 데이터를 텍스트로 처리하고 싶을 때 사용
* **비어있음 → 문자**: 빈 값이 있는 컬럼을 문자열로 처리

**기준 일자 설정**

기준 일자는 Xpert 데이터센터에서 **모든 데이터 처리의 기준**이 되는 핵심 날짜입니다. 필터링, 내보내기 및 데이터센터 내 날짜 기반 검색과 분석의 핵심 요소로 작용합니다.

{% hint style="warning" %}
**매체, 트래커, 호스팅** 데이터 업로드 시 기준 일자를 지정하는 것을 **강력 권장**드립니다.

기준 일자를 지정하지 않을 경우 데이터센터에서 날짜 필터링이 제대로 작동하지 않습니다.
{% endhint %}

* **필수 형식**: `YYYY-MM-DD` (예: 2025-08-09)
* 다른 형식의 날짜는 업로드가 불가합니다.
* 형식이 불일치할 경우 데이터를 수정한 후 재업로드가 필요합니다.

## 5단계: 데이터 수정 및 재검증 <a href="#id-6" id="id-6"></a>

### 7. 데이터 수정 및 재검증 <a href="#undefined" id="undefined"></a>

업로드한 데이터에 형식 오류가 있는 경우 `업로드 데이터 확인` 창에 오류가 표시되며, 데이터 수정 및 재검증으로 통해 업로드를 완료할 수 있습니다.

**일반적인 형식 오류**

* **CSV 파일**: 인코딩 문제로 인해 한글이 깨지는 경우
* **Excel 파일**: 잘못된 시트를 선택하거나, 병합된 셀이 존재할 경우
* **공통**: 일자 컬럼의 날짜 형식이 잘못되었거나, 예상과 다른 데이터 타입으로 인식된 경우

**형식 오류 해결 프로세스**

1. **파일 수정**: 원본 파일에서 오류가 발생한 데이터를 직접 수정합니다.
2. **파일 재업로드**: 업로드 데이터 확인 팝업의 **파일** 모양 아이콘을 클릭합니다.
3. **수정된 파일 선택**: 문제를 해결한 새로운 파일을 선택하여 업로드합니다.
4. **재검증**: 수정된 데이터로 다시 형식 검증을 진행합니다.
5. **반복**: 모든 문제가 해결될 때까지 위 과정을 반복합니다.

{% hint style="warning" %}
이때, 기존에 업로드한 파일과 **파일 형식이 동일하게 유지**되도록 주의합니다. (예. CSV → CSV, Excel → Excel)

재업로드를 완료하면 인코딩 설정 또는 시트 선택사항을 다시 확인해야 하며,

컬럼 구조가 변경된 경우 전체 검증 과정이 재진행되오니 참고하시기 바랍니다.
{% endhint %}

### 8. 업로드 완료 <a href="#undefined" id="undefined"></a>

모든 검증이 완료되면 팝업 창의 `확인` 버튼을 누른 후, `업로드 데이터 확인` 버튼에 파란 체크 표시가 나타나면 **완료** 버튼을 클릭할 수 있습니다.

데이터가 Xpert 데이터센터로 안전하게 업로드되며, 이후 데이터 업로드 관리 화면에서 상태 확인이 가능합니다.