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

# 가져오기로 기존 레코드를 업데이트

> CSV 가져오기를 사용해 레코드를 일괄 업데이트하는 완전한 단계별 가이드.

## 개요

여러 레코드를 한 번에 업데이트해야 하나요? 하나씩 편집하는 대신 CSV 가져오기를 사용해 기존 레코드를 일괄 업데이트하세요.

**사용 사례:**

* 여러 사람의 직함 업데이트
* 회사 정보를 일괄 변경
* 새 사용자 지정 필드에 데이터 추가
* 여러 레코드의 데이터 오류 수정

## 작동 방식

기존 레코드와 일치하는 **고유 식별자**가 포함된 파일을 가져오면, Twenty는 중복을 생성하는 대신 해당 레코드를 업데이트합니다.

| 고유 식별자가...       | Twenty가...                 |
| ---------------- | -------------------------- |
| 기존 레코드와 일치함      | **업데이트** 기존 레코드            |
| 어떤 레코드와도 일치하지 않음 | **생성** 새 레코드               |
| 파일에 없음           | **생성** 새 레코드(자동 생성된 ID 포함) |

<Warning>
  **다중 선택 필드는 병합되지 않고 덮어써집니다.**

  레코드에 `Option A`와 `Option B`가 선택되어 있고 `["Option C"]`를 가져오면, 가져온 후 해당 레코드에는 `Option C`만 남습니다. 가져오면 이전 선택 항목이 모두 대체됩니다 — 기존 선택에 추가되지 않습니다.

  기존 값을 유지하려면 가져오기에 모두 포함하세요: `["Option A","Option B","Option C"]`
</Warning>

## 1단계: 현재 데이터 내보내기

먼저, 업데이트하려는 레코드를 내보내세요:

1. 해당 객체(사람, 회사 등)로 이동합니다.
2. **필요한 열을 추가** — 업데이트하려는 필드를 표시하려면 **옵션 → 필드**를 클릭하세요
3. **필요하다면 필터링** — 업데이트하려는 레코드만으로 범위를 좁히세요
4. **⋮** → **뷰 내보내기**를 클릭
5. CSV 파일을 저장하세요

<Note>**먼저 내보내는 이유?** 내보낸 파일은 올바른 형식을 갖추고 고유 식별자를 포함하며, 가져오는 동안 자동으로 매핑됩니다.</Note>

### 내보내지는 내용

* 현재 보기에서 표시되는 모든 열
* 레코드의 고유 식별자(`id`, `email`, `domain`)
* 수정할 수 있는 현재 필드 값

## 2단계: CSV 파일 편집

내보낸 파일을 스프레드시트 애플리케이션(Excel, Google Sheets 등)에서 여세요:

1. **고유 식별자 열을 유지** — `id`, `email`, `domain`을 삭제하지 마세요
2. 변경하려는 열의 값을 **업데이트**하세요
3. **업데이트할 필요가 없는 열은 제거하세요** (선택 사항이지만 더 깔끔합니다)
4. **고유 식별자 값을 변경하지 마세요** — 그렇지 않으면 Twenty가 새 레코드를 생성합니다

### 예시: 직함 업데이트

**내보낸 파일:**

```csv theme={null}
id,email,firstName,lastName,jobTitle
550e8400-e29b-41d4-a716-446655440001,john@acme.com,John,Smith,Sales Rep
550e8400-e29b-41d4-a716-446655440002,jane@acme.com,Jane,Doe,Sales Rep
550e8400-e29b-41d4-a716-446655440003,bob@acme.com,Bob,Johnson,Sales Rep
```

**편집 후:**

```csv theme={null}
id,email,firstName,lastName,jobTitle
550e8400-e29b-41d4-a716-446655440001,john@acme.com,John,Smith,Account Executive
550e8400-e29b-41d4-a716-446655440002,jane@acme.com,Jane,Doe,Senior Account Executive
550e8400-e29b-41d4-a716-446655440003,bob@acme.com,Bob,Johnson,Account Executive
```

<Warning>
  **고유 식별자 값을 변경하지 마세요.**

  `john@acme.com`을 `john.smith@acme.com`으로 변경하면 Twenty는 기존 레코드를 업데이트하는 대신 새 레코드를 생성합니다.
</Warning>

## 3단계: 업데이트된 파일 가져오기

1. 객체로 이동
2. **⋮** → **레코드 가져오기**를 클릭
3. 편집한 CSV 파일을 업로드하세요
4. **고유 식별자가 매핑되었는지 확인** — `email`, `domain`, `id`가 올바르게 매핑되었는지 검증하세요
5. 필드 매핑을 검토하세요
6. 오류가 있는지 확인하세요
7. **확인**을 클릭

Twenty는 고유 식별자로 레코드를 매칭하여 새 값으로 업데이트합니다.

## 적합한 고유 식별자 선택

| 객체            | 권장        | 대안   | 노트                  |
| ------------- | --------- | ---- | ------------------- |
| **사람들**       | `이메일`     | `id` | 이메일은 사람이 읽기 쉬움      |
| **회사**        | `도메인`     | `id` | 도메인은 사람이 읽기 쉬움      |
| **사용자 지정 개체** | 임의의 고유 필드 | `id` | 사용자 지정 고유 필드를 사용하세요 |

<Note>**하나의 고유 식별자만 사용하세요.** `email`과 `id`를 둘 다 매핑하지 마세요. 이로 인해 혼란과 오류가 발생할 수 있습니다.</Note>

### 사용자 지정 고유 필드 사용

고유로 표시된 사용자 지정 필드(다른 시스템의 외부 ID 등)가 있는 경우:

1. 내보내기와 가져오기에 해당 필드를 포함하세요
2. 가져올 때 해당 필드를 매핑하세요
3. Twenty가 해당 필드로 매칭합니다

## 4단계: 업데이트 확인

가져온 후:

1. 업데이트된 레코드 몇 개를 열어보세요
2. 변경 사항이 적용되었는지 확인하세요
3. 중복 레코드가 생성되지 않았는지 확인하세요

## 파일에 없는 필드는 어떻게 되나요?

**가져오기 파일에 포함되지 않은 필드는 변경되지 않습니다.**

| 파일에 포함된 항목...                | 결과                                   |
| ---------------------------- | ------------------------------------ |
| `email`, `jobTitle`          | `jobTitle`만 업데이트되며, 다른 필드는 그대로 유지됩니다 |
| `email`, `jobTitle`, `phone` | `jobTitle`과 `phone`이 업데이트됩니다         |

즉, 변경하려는 필드(및 고유 식별자)만 포함하면 됩니다.

## 업데이트와 새 레코드 조합

하나의 가져오기에서 기존 레코드를 업데이트하고 새 레코드를 생성할 수 있습니다:

```csv theme={null}
email,firstName,lastName,jobTitle
john@acme.com,John,Smith,Senior Manager    ← Updates existing (email matches)
newperson@acme.com,New,Person,Analyst      ← Creates new (email doesn't match)
```

## 피해야 할 일반적인 실수

| 실수              | 문제                                                     | 결과                 | 해결책                               |
| --------------- | ------------------------------------------------------ | ------------------ | --------------------------------- |
| **고유 식별자 변경**   | `john@acme.com`을 `john.smith@acme.com`으로 변경함           | 업데이트 대신 새 레코드를 생성함 | 고유 식별자를 변경하지 마세요                  |
| **여러 개의 고유 필드** | `email`과 `id`를 모두 매핑함                                  | 매칭 충돌 가능성          | 고유 식별자를 하나만 매핑하세요                 |
| **고유 식별자 없음**   | 파일에 `firstName`, `lastName`, `jobTitle`만 있음            | 모든 행이 새 레코드를 생성함   | 항상 `email`, `domain`, `id`를 포함하세요 |
| **대소문자 불일치**    | 파일에는 `John@acme.com`이 있지만 Twenty에는 `john@acme.com`이 있음 | 새 레코드 생성           | 정확한 값을 얻으려면 Twenty에서 내보내세요        |

## FAQ

<AccordionGroup>
  <Accordion title="일부 레코드가 아직 없으면 어떻게 하나요?">
    고유 식별자가 기존 레코드와 일치하지 않는 레코드는 새 레코드로 생성됩니다. 이렇게 하면 하나의 가져오기에서 업데이트와 생성을 함께 수행할 수 있습니다.
  </Accordion>

  <Accordion title="필드 값을 비울 수 있나요?">
    예, CSV에서 해당 셀을 비워두세요. 가져오면 기존 레코드의 해당 필드 값이 비워집니다.
  </Accordion>

  <Accordion title="가져오기에 포함하지 않은 필드는 어떻게 되나요?">
    가져오기 파일에 없는 필드는 기존 레코드에서 변경되지 않습니다. 포함한 필드만 업데이트됩니다.
  </Accordion>

  <Accordion title="관계 필드(예: 회사)를 업데이트할 수 있나요?">
    예! 관계의 고유 식별자(예: `companyDomain`)를 포함하고 관계 필드에 매핑하세요. 관계가 업데이트됩니다.
  </Accordion>

  <Accordion title="어떤 레코드는 업데이트되고 어떤 레코드는 생성되는지 어떻게 알 수 있나요?">
    가져오기 검토 단계에서 Twenty가 고유 식별자 일치 여부를 기준으로 업데이트될 레코드와 생성될 레코드 수를 보여줍니다.
  </Accordion>

  <Accordion title="일괄 업데이트를 되돌릴 수 있나요?">
    자동 실행 취소 기능은 없습니다. 대량 업데이트 전에 데이터를 백업용으로 내보내는 것을 권장합니다.
  </Accordion>
</AccordionGroup>

## 모범 사례

1. **먼저 내보내기** — 올바른 형식을 보장하려면 항상 내보내기에서 시작하세요
2. **업데이트 전에 백업** — 대량 변경 전에 데이터를 내보내세요
3. **일부 레코드로 테스트** — 대량 작업 전에 먼저 5\~10개의 레코드를 업데이트해 보세요
4. **사람이 읽기 쉬운 식별자 사용** — `email`과 `domain`이 `id`보다 확인하기 더 쉽습니다
5. **필요한 열만 포함** — 열이 적을수록 오류 가능성이 줄어듭니다

## 문제 해결

문제가 있으신가요? 확인하세요:

* [가져오기 오류 수정](/l/ko/user-guide/data-migration/how-tos/fix-import-errors)
* [고유성 제약 조건](/l/ko/user-guide/data-migration/capabilities/uniqueness-constraints)
* [필드 매핑 레퍼런스](/l/ko/user-guide/data-migration/capabilities/field-mapping)