---
title: CSV 파일 가져오기
slug: docs-kr/parse-dashboard/core/import-csv
description: Back4App에서 새 앱 설정부터 CSV 파일 가져오기까지 단계별 가이드입니다. 개발자를 위한 기술적 설명 포함.
createdAt: 2025-01-17T18:18:58.474Z
---

## 소개

CSV 파일을 가져오면 사용자가 Parse 테이블에 데이터를 쉽게 가져올 수 있습니다.

## 전제 조건

:::hint{type="info"}
**이 튜토리얼을 시작하려면 다음이 필요합니다:**

- Back4App에서 생성된 앱.
  - 다음 링크를 참조하세요 [새 앱 만들기 튜토리얼](https://www.back4app.com/docs/get-started/new-parse-app) Back4App에서 앱을 만드는 방법을 배우기 위해.
:::

## 1 - 새로운 Back4App 앱 만들기

우선, Back4App에서 기존 앱이 생성되어 있는지 확인해야 합니다. 그러나 새로운 사용자라면 [이 튜토리얼](https://www.back4app.com/docs/get-started/new-parse-app)을 확인하여 앱을 만드는 방법을 배울 수 있습니다.

## 2 - 데이터를 가져오기 위한 클래스 만들기

새로 생성된 앱에서 데이터베이스 브라우저로 이동하여 클래스 만들기 버튼을 클릭하세요.

::Image[]{src="https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/MIuWuylAQjxa-xjLXkykN_image.png" size="50" width="448" height="579" position="center" showCaption="false"}

사용자 정의 클래스를 만들고 이름을 지정하세요. 저는 제 것을 TestClass라고 불렀지만, 여러분은 원하는 이름으로 부를 수 있습니다.
관례상 클래스 이름은 대문자로 시작하고, CamelCase 형식이며, 공백 및 기호와 같은 특수 문자를 포함하지 않아야 합니다.
완료되면 클래스 만들기를 클릭하세요.

::Image[]{src="https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/xzqZee4RmhJgZo1hoGClT_image.png" size="60" width="988" height="826" position="center" showCaption="false"}

## 3 - CSV 파일 만들기

CSV 파일은 가져오기 위해 올바른 형식이어야 합니다.

**올바른 형식 매개변수**:

구분 기호는 쉼표 , 여야 하며 세미콜론 ;가 아니어야 합니다.


스프레드시트 소프트웨어를 조정하여 쉼표를 구분 기호로 출력하도록 하세요


첫 번째 줄은 열 이름이 됩니다


구문 분석은 자동으로 `문자열`, `숫자` 및 `부울`로 변환됩니다.


날짜는 두 개의 열이 필요합니다: `date.__typespecifies` 날짜 유형, `date.isospecifies` 날짜 형식


GeoPoints는 세 개의 열이 필요합니다: `columnName.__typespecifies` 지오포인트 유형,
`columnName.latitudespecifies` 위도, `columnName.longitudespecifies` 경도.


배열은 큰따옴표로 전달됩니다.


포인터는 세 개의 열이 필요합니다: `columnName.__typespecifies` 포인터 유형, `columnName.classNamespecifies` 대상 클래스, `columnName.objectIdspecifies` 대상 클래스의 objectId

참고를 위해 몇 가지 예시입니다:

세 개의 열: columnStringA는 문자열을, columnStringB는 문자열을, columnNumberC는 숫자를 보유합니다.

columnStringA,columnStringB,columnNumberC
stringA,StringB,12
stringA2,StringB2,13

두 개의 열: columnStringA는 문자열을, columnBooleanB는 부울을 보유합니다.

열 문자열 A, 열 불리언 B
문자열 A, TRUE
문자열 A2, FALSE

두 개의 열: 열 문자열 A와 열 문자열 B는 문자열을 보유하고, 열 배열 C는 배열을 보유합니다.

열 문자열 A, 열 문자열 B, 열 배열 C
"문자열 A, 쉼표가 있는", 문자열 B,`"[1,2,3]"`
문자열 A2,"문자열 B, 쉼표가 있는",`"["A", "B", "C"]"`

두 개의 열: 열 문자열 A는 문자열을 보유하고, 두 번째 열은 ISO 형식의 날짜를 보유합니다.

열 문자열 A,`date.__type`,`date.iso`
문자열 A, 날짜, 2020-01-16
문자열 A2, 날짜, 2020-01-17

두 개의 열: 열 문자열 A는 문자열을 보유하고, 두 번째 열은 GeoPoint를 보유합니다.

열 문자열 A,`geo.__type`,`geo.latitude`,`geo.longitude`
문자열 A, GeoPoint, 1, 2
문자열 A2, GeoPoint, -5, -6

여기에서 다운로드할 수 있는 샘플 CSV 파일을 찾을 수 있습니다:

[여기에서 다운로드](https://www.back4app.com/docs/assets/downloads/SampleCSVFile.csv)

포인터에 대한 예시는 아래를 확인하세요:

한 개의 열: 포인터를 보유

`team.__type`,team.className,team.objectId
포인터, 팀, XWDSM4xxQ8
포인터, 팀, CD9nAlDaEG
포인터, 팀, kRGJPuZyXD

::Image[]{src="https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/uE9mTlnoAR6UhMO1R2lwa_image.png" size="50" width="410" height="96" position="center" showCaption="false"}

이 예제에서는 objectId가 Team 클래스의 기존 ones에 해당한다고 가정하십시오.

다운로드할 샘플 CSV 파일을 확인하십시오:

[여기에서 다운로드](https://www.back4app.com/docs/assets/downloads/import-pointer-csv.csv)

## 4 - 데이터 가져오기

데이터베이스 브라우저에서 새로 생성한 클래스를 선택한 후, 화면 오른쪽 상단의 Notes 버튼을 클릭하고 데이터 가져오기를 선택하십시오.

::Image[]{src="https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/N3EnnPmrRItGfbN5Hz4_3_image.png" size="50" width="414" height="619" position="center" showCaption="false"}

파일 업로드 버튼을 클릭하고, CSV 파일을 선택한 후 가져오기 버튼을 클릭하십시오.

![](https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/VakvVAlB0vKaCmJe6aWfA_image.png)

## 5 - 이메일 확인 대기

CSV 파일이 꽤 클 수 있으므로, 백그라운드에서 데이터를 가져오기 위해 비동기 작업이 실행됩니다. 이는 가져오는 진행 상황이나 성공 메시지를 볼 수 없음을 의미합니다.
작업이 끝나면 작업이 성공적으로 완료되었고 데이터가 가져와졌다는 이메일 메시지를 받거나, 작업이 성공하지 못했으며 어떤 열/행이 실패했는지 설명하는 이메일을 받게 됩니다.

이 이메일을 받기 전에 대시보드를 새로 고치려고 하면, 데이터가 누락되거나 아예 데이터가 없을 수 있습니다. 작업이 아직 진행 중이기 때문입니다.

이메일을 받고 가져오기가 성공적이었다면, 브라우저를 강제로 새로 고치는 것을 권장합니다 (Mac에서는 CMD + Shift + R, Windows에서는 CTRL + Shift + R, Chrome 모두 해당) 새로운 스키마가 검색되고 데이터가 제대로 표시되도록 하기 위해서입니다.