> ## Documentation Index
> Fetch the complete documentation index at: https://www.integrate.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ETL: File Upload 소스로 즉시 ETL을 써보기

> Integrate.io ETL이 2026년 1월에 출시한 File Upload 소스를 사용하여 외부 스토리지 없이 직접 파일을 업로드하고 새로운 데이터 파이프라인을 빠르게 시도해 볼 수 있는 방법을 소개합니다. Integrate.io 사용자 가이드의 한 항목입니다.

시작하며

Xplenty는 지금까지 “데이터의 읽는 곳과 쓰기 곳은 고객이 소유한 리소스에 있어야 한다”는 정책을 유지해 왔습니다. 이 정책 자체는 현재도 변함없지만, 한편으로 “데이터 파이프라인(패키지) 구축 시 새로운 시도를 하기 어렵다”는 의견도 있었습니다.

이에 2026년 1월에 출시된 File Upload 소스는 바로 이 과제를 해결하는 기능입니다. 본 가이드에서는 File Upload 소스의 개요, 사용법, 제한 사항에 대해 상세히 설명합니다.
File Upload 소스란?

File Upload 소스를 한마디로 표현하면, **Xplenty가 제공하는 읽기 전용 공간**입니다.
일반적인 File Storage 소스는 클라우드 스토리지 등의 외부 커넥터 연결이 필요하지만, File Upload 소스는 커넥터 설정이 불필요하며, **로컬 영역의 파일을 직접 업로드하기만** 하면 패키지 테스트를 수행할 수 있습니다.

업로드된 파일은 Xplenty가 마련한 영역에 저장되며, File Upload 소스가 사용될 때마다 읽혀집니다.
\[

<Frame>
  <img src="https://mintcdn.com/integrateio/erg_659RimicWdnj/images/creating-packages/filestorage-part05-ko/image-1.webp?fit=max&auto=format&n=erg_659RimicWdnj&q=85&s=df7fdb4158a9f616cfac35a157b47648" alt="filestorage-part05-ko image 1" width="1200" height="828" data-path="images/creating-packages/filestorage-part05-ko/image-1.webp" />
</Frame>

]\([https://cdn.filestackcontent.com/auto\_image//compress/cache=expiry:max/6HVSR2CQyuoVraIKQGpo](https://cdn.filestackcontent.com/auto_image//compress/cache=expiry:max/6HVSR2CQyuoVraIKQGpo))
사전 준비: 기능 활성화

File Upload 소스를 이용하려면 먼저 File Uploader 화면에서 해당 기능을 활성화 해야 합니다.

* Xplenty 관리 화면에서 **Settings - File Uploader** 열기

*

**Provision File Upload** 버튼 클릭\[

<Frame>
  <img src="https://mintcdn.com/integrateio/erg_659RimicWdnj/images/creating-packages/filestorage-part05-ko/image-2.webp?fit=max&auto=format&n=erg_659RimicWdnj&q=85&s=33ce418a58234cfdac0b380ac5b6521a" alt="filestorage-part05-ko image 2" width="1200" height="828" data-path="images/creating-packages/filestorage-part05-ko/image-2.webp" />
</Frame>

]\([https://cdn.filestackcontent.com/auto\_image//compress/cache=expiry:max/GCKDGPP2RQG5mG4ADfCh](https://cdn.filestackcontent.com/auto_image//compress/cache=expiry:max/GCKDGPP2RQG5mG4ADfCh))

* 화면에 **Status: Active** 및 Created Date 날짜가 표시되면 설정 완료\[

<Frame>
  <img src="https://mintcdn.com/integrateio/erg_659RimicWdnj/images/creating-packages/filestorage-part05-ko/image-3.webp?fit=max&auto=format&n=erg_659RimicWdnj&q=85&s=84f840ac779844509eee352b7a801897" alt="filestorage-part05-ko image 3" width="1200" height="828" data-path="images/creating-packages/filestorage-part05-ko/image-3.webp" />
</Frame>

]\([https://cdn.filestackcontent.com/auto\_image//compress/cache=expiry:max/LGvIF4MpTKuN47iUQGHy](https://cdn.filestackcontent.com/auto_image//compress/cache=expiry:max/LGvIF4MpTKuN47iUQGHy))

* 파일 업로드 기능이 비활성화된 경우, 파일 업로드 소스 화면은 아래 그림과 같습니다. 「Configure File Uploader」 버튼을 클릭하면 위에서 설명한 **Settings - File Uploader**로 이동합니다.\[

<Frame>
  <img src="https://mintcdn.com/integrateio/erg_659RimicWdnj/images/creating-packages/filestorage-part05-ko/image-4.webp?fit=max&auto=format&n=erg_659RimicWdnj&q=85&s=e8314bffc68fb170b6be5fe1bcd7015d" alt="filestorage-part05-ko image 4" width="1200" height="828" data-path="images/creating-packages/filestorage-part05-ko/image-4.webp" />
</Frame>

]\([https://cdn.filestackcontent.com/auto\_image//compress/cache=expiry:max/7zX3fsCFRluMgn1pG0Qk](https://cdn.filestackcontent.com/auto_image//compress/cache=expiry:max/7zX3fsCFRluMgn1pG0Qk))

파일 업로드 소스 사양

File Upload 소스의 화면 구성 및 사양은 File Storage 소스와 거의 동일합니다. 주요 지원 형식은 다음과 같습니다.

* 단계 1 - Connection 지정

* 파일 업로더를 활성화하면 설정 불필요\[

<Frame>
  <img src="https://mintcdn.com/integrateio/erg_659RimicWdnj/images/creating-packages/filestorage-part05-ko/image-5.webp?fit=max&auto=format&n=erg_659RimicWdnj&q=85&s=1fc301ca14c83b33e8bbdd27da7e7000" alt="filestorage-part05-ko image 5" width="1019" height="349" data-path="images/creating-packages/filestorage-part05-ko/image-5.webp" />
</Frame>

]\([https://cdn.filestackcontent.com/auto\_image//compress/cache=expiry:max/vksHn4nReScnE0iJ3T6q](https://cdn.filestackcontent.com/auto_image//compress/cache=expiry:max/vksHn4nReScnE0iJ3T6q))

* 단계 2 - 소스 파일 및 형식 지정

* 소스 경로 - 로컬 파일을 드래그 앤 드롭으로 간편하게 지정 가능(\[Upload File] 버튼으로 파일 선택 상자도 사용 가능)\[

<Frame>
  <img src="https://mintcdn.com/integrateio/erg_659RimicWdnj/images/creating-packages/filestorage-part05-ko/image-6.webp?fit=max&auto=format&n=erg_659RimicWdnj&q=85&s=78127c1c4c79b28f6016bbb169f3d4b5" alt="filestorage-part05-ko image 6" width="1200" height="828" data-path="images/creating-packages/filestorage-part05-ko/image-6.webp" />
</Frame>

]\([https://cdn.filestackcontent.com/auto\_image//compress/cache=expiry:max/4FWpEtoBTo21ppXeLDpP)\[](https://cdn.filestackcontent.com/auto_image//compress/cache=expiry:max/4FWpEtoBTo21ppXeLDpP\)\[)

<Frame>
  <img src="https://mintcdn.com/integrateio/erg_659RimicWdnj/images/creating-packages/filestorage-part05-ko/image-7.webp?fit=max&auto=format&n=erg_659RimicWdnj&q=85&s=f136f548f0adb2d84fa2da0e2e6885bb" alt="filestorage-part05-ko image 7" width="1200" height="828" data-path="images/creating-packages/filestorage-part05-ko/image-7.webp" />
</Frame>

]\([https://cdn.filestackcontent.com/auto\_image//compress/cache=expiry:max/UqncF5rSNiSZgGzBBStD](https://cdn.filestackcontent.com/auto_image//compress/cache=expiry:max/UqncF5rSNiSZgGzBBStD))

* 레코드 구분자 & 레코드 유형 - FileStorage와 마찬가지로 CSV / Excel / Json / Parquet / Raw 형식의 파일을 지정할 수 있습니다.

* CSV
  \[

<Frame>
  <img src="https://mintcdn.com/integrateio/erg_659RimicWdnj/images/creating-packages/filestorage-part05-ko/image-8.webp?fit=max&auto=format&n=erg_659RimicWdnj&q=85&s=f77faf7f4a47c35f1a830f83f3eea2aa" alt="filestorage-part05-ko image 8" width="545" height="404" data-path="images/creating-packages/filestorage-part05-ko/image-8.webp" />
</Frame>

]\([https://cdn.filestackcontent.com/auto\_image//compress/cache=expiry:max/VMsoedTu0BA4jenveVgr](https://cdn.filestackcontent.com/auto_image//compress/cache=expiry:max/VMsoedTu0BA4jenveVgr))

* Excel(xls / xlsx)
  \[

<Frame>
  <img src="https://mintcdn.com/integrateio/erg_659RimicWdnj/images/creating-packages/filestorage-part05-ko/image-9.webp?fit=max&auto=format&n=erg_659RimicWdnj&q=85&s=5214d9dbbe0485dcb7ee8ace270bd228" alt="filestorage-part05-ko image 9" width="568" height="397" data-path="images/creating-packages/filestorage-part05-ko/image-9.webp" />
</Frame>

]\([https://cdn.filestackcontent.com/auto\_image//compress/cache=expiry:max/1oSh6rjSauC7nwDf0NFe](https://cdn.filestackcontent.com/auto_image//compress/cache=expiry:max/1oSh6rjSauC7nwDf0NFe))

* JSON / Raw / Parquet
  \[

<Frame>
  <img src="https://mintcdn.com/integrateio/erg_659RimicWdnj/images/creating-packages/filestorage-part05-ko/image-10.webp?fit=max&auto=format&n=erg_659RimicWdnj&q=85&s=905c5cd99ddccc3e66a9527cfca69717" alt="filestorage-part05-ko image 10" width="562" height="150" data-path="images/creating-packages/filestorage-part05-ko/image-10.webp" />
</Frame>

]\([https://cdn.filestackcontent.com/auto\_image//compress/cache=expiry:max/nkSFqlKWRFGwwm0bfvqI](https://cdn.filestackcontent.com/auto_image//compress/cache=expiry:max/nkSFqlKWRFGwwm0bfvqI))

* JSON(End of File)
  \[

<Frame>
  <img src="https://mintcdn.com/integrateio/erg_659RimicWdnj/images/creating-packages/filestorage-part05-ko/image-11.webp?fit=max&auto=format&n=erg_659RimicWdnj&q=85&s=39654992c82d60785dfdcd1ff63da3e4" alt="filestorage-part05-ko image 11" width="519" height="280" data-path="images/creating-packages/filestorage-part05-ko/image-11.webp" />
</Frame>

]\([https://cdn.filestackcontent.com/auto\_image//compress/cache=expiry:max/hNKx65GITLCsdq8tT6kw](https://cdn.filestackcontent.com/auto_image//compress/cache=expiry:max/hNKx65GITLCsdq8tT6kw))

* XML(End of File)
  \[

<Frame>
  <img src="https://mintcdn.com/integrateio/erg_659RimicWdnj/images/creating-packages/filestorage-part05-ko/image-12.webp?fit=max&auto=format&n=erg_659RimicWdnj&q=85&s=ad196a561ab5371bb22a764a55714a5f" alt="filestorage-part05-ko image 12" width="536" height="238" data-path="images/creating-packages/filestorage-part05-ko/image-12.webp" />
</Frame>

]\([https://cdn.filestackcontent.com/auto\_image//compress/cache=expiry:max/rMTcTmTaKjyuI1fj49BA](https://cdn.filestackcontent.com/auto_image//compress/cache=expiry:max/rMTcTmTaKjyuI1fj49BA))

* 소스 작업 - 읽기 대상이 된 파일의 처리 방식 지정\[

<Frame>
  <img src="https://mintcdn.com/integrateio/erg_659RimicWdnj/images/creating-packages/filestorage-part05-ko/image-13.webp?fit=max&auto=format&n=erg_659RimicWdnj&q=85&s=77f6d3dc827d63037793b6c53a664779" alt="filestorage-part05-ko image 13" width="544" height="202" data-path="images/creating-packages/filestorage-part05-ko/image-13.webp" />
</Frame>

]\([https://cdn.filestackcontent.com/auto\_image//compress/cache=expiry:max/3dUsBRkUR5656swQheKM](https://cdn.filestackcontent.com/auto_image//compress/cache=expiry:max/3dUsBRkUR5656swQheKM))

* Process all files directly from source - 기본 동작

* Copy, merge and process all files - 읽기 파일의 인코딩 지정이 필요한 경우 선택

* 단계 3 - 입력 항목의 확인

* 가져오기 항목 및 데이터 확인 (50건)
  \[

<Frame>
  <img src="https://mintcdn.com/integrateio/erg_659RimicWdnj/images/creating-packages/filestorage-part05-ko/image-14.webp?fit=max&auto=format&n=erg_659RimicWdnj&q=85&s=ada6c8217031a21a9d54890a3a60f378" alt="filestorage-part05-ko image 14" width="972" height="685" data-path="images/creating-packages/filestorage-part05-ko/image-14.webp" />
</Frame>

]\([https://cdn.filestackcontent.com/auto\_image//compress/cache=expiry:max/5AGF6LSJWvZ30CzCUyAz](https://cdn.filestackcontent.com/auto_image//compress/cache=expiry:max/5AGF6LSJWvZ30CzCUyAz))

이처럼 File Upload의 구성과 사양은 File Storage·소스와 거의 차이가 없으므로, File Storage·소스 사용법에 익숙한 분은 바로 사용할 수 있습니다.
사용 용도의 추천

Xplenty가 예상하는 File Upload 소스의 용도는 다음 3가지 정도가 있습니다. 하지만 응용 가능한 사용법은 고객님의 아이디어에 달려 있습니다.

### 1. 로컬에 가지고 있는 샘플 데이터로 사전 확인

로컬에 있는 데이터로 Xplenty의 변환·전송 동작을 사전에 확인하고 싶은 경우, 이 File Upload가 효과적입니다.

### 2. 소량의 데이터를 여러 파이프라인에서 가볍게 쓰고 싶을 떄

**한 번 생성, 다목적 활용**이라는 말 그대로 특정 파일을 업로드할 수 있는 File Upload를 여러 데이터 플로우에 복사하여 붙여넣기(Ctrl+C, Ctrl+V)로 여러 번 사용할 수 있습니다. 하나의 파일 제한 용량만 지킨다면, File Upload 소스의 생성 개수에는 제한이 없습니다.

### 3. 마이그레이션에 임시 참조용 데이터가 필요할 때

마이그레이션은 기존 시스템 데이터를 그대로 전송하기도 하고, 새로운 형식에 맞춰 데이터를 변경하기도 합니다. 이 데이터 변환에 임시로 사용하는 마스터 데이터의 처리가 문제로 남습니다.
데이터 등록이나 마이그레이션 후의 데이터 삭제 등 나중의 작업을 고려하면 데이터베이스라는 선택지도 번거로운 점이 많습니다.
이때 File Upload 소스의 선택은 유지보수가 거의 필요 없는 대안이 될 수 있습니다.
마이그레이션에 사용할 수 있을 뿐만 아니라 업로드된 파일은 저장 기간 후 자동 삭제되므로, 마이그레이션에 사용된 **데이터 플로만 삭제하면 유지보수 작업이 거의 필요없습니다**.

이처럼 File Upload 소스의 생성 수에는 상한이 없으므로 여러 개의 소규모 데이터를 병행 처리하는 용도에도 적합합니다.
제한 사항

편리한 File Upload 소스이지만, 아래 3가지 제한 사항이 있습니다. 사전에 확인하시기 바랍니다.

### 1. 업로드 가능한 파일 크기는 최대 50MB

하나의 File Upload 소스에 업로드할 수 있는 파일 크기는 50MB까지입니다. 소스 생성 개수에는 제한이 없으나 개별 파일 크기에 유의하시기 바랍니다. 이는 Integrate.io 리소스를 무료로 제공하기 위한 제한 사항입니다.

### 2. 인식되는 것은 마지막으로 업로드한 파일만

하나의 File Upload 소스에 여러 파일을 업로드하는 것은 가능하지만, **실제로 읽히는 것은 마지막으로 업로드한 파일 하나뿐**입니다. 또한, 특정 File Upload 소스에 업로드된 파일은 다른 File Upload 소스에서는 참조할 수 없습니다.

### 3. 파일 저장 기간은 30일

업로드한 파일의 저장 기간은 **업로드 시점부터 30일간**입니다. 기간이 지난 파일은 자동으로 삭제됩니다.

File Upload 소스는 어디까지나 **테스트 및 임시 사용을 목적으로 한 기능**으로, 장기적인 파일 저장을 지원하지 않습니다. 지속적으로 사용하려면 정기적인 파일 재업로드가 필요합니다.

📌 제한 사항 변경을 원하시는 분은 당사 서포트팀으로 문의해 주십시오.
요약

File Upload 소스는 **외부 스토리지 준비 없이 즉시 Xplenty 데이터 플로우를 시험해 볼 수 있는** 매우 간편한 기능입니다. “지금 가지고 있는 데이터로 동작을 확인하고 싶다”는 분께 특히 추천합니다.

Integrate.io에서 File Upload 소스를 꼭 시험해 보시기 바랍니다. 궁금한 점이 있으시면 부담없이 서포트팀으로 문의해 주십시오.

##

\<!-- Google Tag Manager hidden fields -->

\<!-- End Google Tag Manager hidden fields -->

\<!-- Text input-->

Get Started

Free 7-day trial. Easy setup. Cancel any time