---
title: 데이터 가져오기/내보내기
info: "데이터를 가져오고 내보내는 방법에 대해 알아보세요."
image: /images/user-guide/import-export-data/cloud.png
sectionInfo: Twenty를 발견하세요, 오픈 소스 CRM입니다.
---

import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';

<Frame>
  <img src="/images/user-guide/import-export-data/cloud.png" alt="Header" />
</Frame>

## 데이터 가져오기

- CSV, XLSX, 또는 XLS 파일을 사용하여 모든 객체의 데이터를 가져올 수 있습니다.
- 업로드하는 각 파일에는 **객체 유형 하나만** 포함해야 합니다 (예: 사람 레코드만).
- 가져오기 기능을 사용하여 **레코드를 생성하거나 업데이트**할 수 있습니다.

### 예상 형식에 맞춘 샘플 파일을 다운로드하세요.

1. 가져올 객체의 보기에 이동하세요.
2. 우측 상단의 `⋮` 아이콘을 클릭한 다음 `레코드 가져오기`를 선택하세요.
3. `샘플 파일 다운로드`를 클릭하세요.

### CSV 준비하기

파일 업로드 전 확인해야 할 항목이 아래에 나와 있습니다.

- 레코드 수를 **파일당 10,000개로 제한**하세요.
- 파일에서 **중복된 항목을 제거**하세요.
  - `People`의 고유성은 기본적으로 `id`와 `email`로 설정되어 있습니다. 데이터 모델을 구성할 때 `People`에서 고유하게 지정된 사용자 정의 필드를 정의할 수도 있습니다.
  - `Companies`의 고유성은 기본적으로 `id`와 `domain`으로 설정되어 있습니다. 데이터 모델을 구성할 때 `Companies`에서 고유하게 지정된 사용자 정의 필드를 정의할 수도 있습니다.
  - 기타 객체, 사용자 정의 객체를 포함하여, 일부 필드를 고유하게 정의할 수 있습니다. 파일을 준비할 때 중복을 포함하지 않도록 하세요.
- 도메인 업로드 시 `https://domain.com` 구문을 사용하는 것이 좋습니다. 이는 메일박스 및 일정과의 연결기에 의해 사용됩니다.
- 관련 레코드의 고유 필드를 제공하여 **객체 간의 관계를 가져올 수 있습니다**.
  - 예시: 사람을 회사에 연결하길 원합니다. 파일에 회사의 `id` 또는 `domain`을 포함하는 모든 `People` 레코드를 포함하는 열을 추가하세요. 업로드 중 이 필드를 매핑할 수 있습니다.
    <Warning>

**중요 참고 사항:**

- Twenty에서 객체 간의 관계는 "일대다" 관계입니다. 즉, 객체 A의 각 레코드는 객체 B의 여러 레코드에 연결될 수 있습니다. 그러나 객체 B의 각 레코드는 객체 A의 하나의 레코드만 소속될 수 있습니다.  그리고 한 사람은 오직 하나의 회사에만 속할 수 있습니다.\*

- 관계의 "여러 측"에 있는 레코드를 포함하는 파일에서 첨부된 객체의 `id` (또는 다른 고유 필드)를 제공하여 가져오기 기능을 통해 관계를 업로드합니다.  
  예시: 사람 레코드를 업로드할 때 회사의 `id` 또는 `domain`을 제공합니다. 회사를 포함한 파일을 업로드할 때 사람의 `id` (또는 `이메일`)을 제공하지 않습니다.\*
  </Warning>

### 파일을 업로드하세요

1. 가져올 객체의 보기에 이동하세요.
2. 우측 상단의 `⋮` 아이콘을 클릭한 다음 `레코드 가져오기`를 선택하세요.
3. `파일 선택`을 클릭하세요.
4. 필드 매핑을 확인하세요.

- 모두 가져올 필요는 없으며, "매핑하지 않음" 옵션을 선택할 수 있습니다.
- 관계의 경우 고유 필드 중 하나만 매핑하는 것이 좋습니다.
- 선택형 및 다중 선택형 필드의 값을 매핑해야 할 수도 있습니다.

5. `다음 단계` 및 `오류가 있는 행 검토`를 클릭하세요. 문제가 있는 셀은 하이라이트됩니다. **해당 자리에서 행을 제거하거나 셀을 직접 업데이트할 수 있습니다.**
6. 완료되면 `확인`을 클릭하세요.

<img src="/images/user-guide/import-export-data/match-columns.png" style={{width:'100%'}}/>

### 가져오기 FAQ

<details><summary>파일을 업로드할 때 중복 문제를 보았습니다. 어떻게 해야 하나요?</summary>

이 기사 상단의 **CSV 준비하기** 섹션을 참조하세요. 중복으로 간주되는 항목에 대한 지침이 포함되어 있습니다.

</details>

<details><summary>객체 간의 관계를 가져올 수 있나요?</summary>

네, 이 기사 상단의 **CSV 준비하기** 섹션을 참조하세요. 관계 가져오기에 대한 섹션이 포함되어 있습니다.

</details>

<details><summary>가져오기 기능을 사용하여 기존 레코드를 업데이트할 수 있나요?</summary>

네, 가져오기 기능을 통해 기존 레코드를 업데이트할 수 있습니다. 레코드를 다시 업로드할 때 id (또는 다른 고유 필드)를 제공하세요.

</details>

<details><summary>다른 도구의 `id`를 마이그레이션할 수 있나요?</summary>

예. 다른 도구의 `id`를 포함하도록 데이터 모델에서 고유로 정의한 필드를 생성해야 합니다. `id`라는 이름은 Twenty id에 사용되기 때문에 보호됩니다.  
이 필드를 사용하여 객체 간의 관계를 생성하려면 본 기사 상단의 **CSV 준비하기** 섹션을 참조하세요. 이는 관계의 가져오기에 대한 섹션을 포함하고 있습니다.

</details>

## 데이터 내보내기

대부분의 객체에서 데이터를 내보낼 수 있으며, 내보내기당 최대 20,000개의 레코드를 다운로드할 수 있습니다.
객체에서 데이터를 내보내려면:

1. 객체 인덱스를 방문하세요.
2. 데이터 내보내기 위한 뷰를 선택하세요. 필요한 레코드를 찾기 위해 열을 숨기거나 추가하여 원하는 열을 구성하고 뷰를 필터링하세요.
3. 우측 상단의 `⋮` 아이콘을 통해 사이드 패널에 접근하세요.
4. `뷰 내보내기`를 클릭하세요.
5. CSV 데이터의 저장 위치를 선택하세요. 기록 수가 많은 경우 내보내기가 시간이 걸릴 수 있음을 유의하세요.

<VimeoEmbed videoId="926226303" title="Video demonstration" />

