---
title: 오류 처리 및 유효성 검사
description: 확인하기 전에 UI에서 가져오기 오류를 검토하고 바로 수정하세요.
---

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

## 가져오기 전 유효성 검사

파일을 업로드하고 필드를 매핑한 후, Twenty는 데이터를 가져오기 **이전에** 유효성 검사를 수행합니다. 이렇게 하면 기존 데이터에 영향을 주지 않고 오류를 찾아 수정할 수 있습니다.

## 작동 방식

1. **업로드**: CSV 파일을 업로드하세요
2. **매핑**: 열을 Twenty 필드에 매핑하세요
3. **검토**: 노란색으로 강조 표시된 잠재적 오류를 확인하세요
4. **오류 수정**: UI에서 바로 수정하세요
5. **확인**: 가져오기를 확인하세요

<VimeoEmbed videoId="1145273857" title="동영상 시연" />

## 오류 표시

문제가 있는 행은 **노란색**으로 강조 표시됩니다. 다음을 수행할 수 있습니다:

* **셀을 직접 편집**하여 오류를 수정하세요
* **행을 제거**하여 완전히 건너뛰세요

이 인라인 편집은 시간을 절약해 줍니다 — 스프레드시트로 돌아가 오류를 수정하고 다시 업로드할 필요가 없습니다.

## 일반적인 오류 유형

### 중복 값

**원인**: 고유 필드(이메일, 도메인)가 Twenty에 이미 존재하거나 파일에 두 번 나타납니다.

**해결 방법**:

* 가져오기 UI에서 중복 값을 편집하세요
* 중복된 행 중 하나를 제거하세요

고유성이 어떻게 적용되는지에 대한 자세한 내용은 [고유성 제약](/l/ko/user-guide/data-migration/capabilities/uniqueness-constraints)을 참조하세요.

### 잘못된 형식

**원인**: 데이터가 예상 형식과 일치하지 않습니다(예: 잘못된 이메일, 잘못된 날짜 형식).

**해결 방법**: 올바른 형식을 사용하도록 셀을 편집하세요.

필드 유형별로 예상되는 형식은 [필드 매핑](/l/ko/user-guide/data-migration/capabilities/field-mapping)을 참조하세요.

### 필수 필드 누락

**원인**: 필수 필드가 비어 있습니다.

**해결 방법**: 필수 필드에 값을 입력하거나 해당 행을 제거하세요.

### 관계를 찾을 수 없음

**원인**: 참조된 레코드가 존재하지 않습니다(예: 가져오지 않은 회사 도메인).

**해결 방법**:

* 상위 레코드를 먼저 가져오세요
* 또는 참조 값을 수정하세요

올바른 가져오기 순서와 레코드를 연결하는 방법은 [관계 가져오기](/l/ko/user-guide/data-migration/capabilities/import-relations)를 참조하세요.

## 오류를 줄이기 위한 팁

1. **템플릿을 다운로드**하여 파일을 가져오기 전에 예상 형식을 확인하세요
2. **데이터 정리**: 먼저 스프레드시트에서 데이터를 정리하세요
3. **올바른 순서로 파일을 가져오세요** 관계를 가져오기 위해 (Companies → People → Opportunities)
4. **소규모 배치로 테스트**: 전체 가져오기 전에 테스트해 보세요
5. **중복 확인**: 업로드 전에 중복을 확인하세요
6. **파일 크기를 10,000개 레코드로 제한하세요** (파일당)
