upstream-twenty/packages/twenty-docs/l/ja/user-guide/data-migration/capabilities/error-handling.mdx

---
title: エラー処理と検証
description: 確定する前に、UI 上でインポートエラーを確認して修正します。
---

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

## インポート前の検証

ファイルをアップロードしてフィールドをマッピングした後、Twenty はインポートする**前**にデータを検証します。 これにより、既存のデータに影響を与えることなく、エラーを検出して修正できます。

## 仕組み

1. **CSV ファイルをアップロード**
2. **列を Twenty のフィールドにマッピング**
3. **黄色で強調表示された潜在的なエラーを確認**
4. **UI で直接エラーを修正**
5. **インポートを確定**

<VimeoEmbed videoId="1145273857" title="デモ動画" />

## エラーの表示

問題のある行は **黄色** で強調表示されます。 次のことができます:

* **セルを直接編集**してエラーを修正
* **行を削除**して完全にスキップ

このインライン編集により時間を節約できます。スプレッドシートに戻ってエラーを修正し、再アップロードする必要はありません。

## よくあるエラーの種類

### 重複した値

**原因**: 一意のフィールド（メール、ドメイン）が Twenty に既に存在するか、ファイル内で 2 回出現しています。

**対処**:

* インポート UI で重複値を編集
* 重複行のいずれかを削除

一意性の適用方法の詳細は[一意性制約](/l/ja/user-guide/data-migration/capabilities/uniqueness-constraints)を参照してください。

### 無効な形式

**原因**: データが期待される形式に一致していません（例: 無効なメールアドレス、日付形式の誤り）。

**対処**: セルを編集して正しい形式にする。

各フィールドタイプの期待される形式は[フィールドマッピング](/l/ja/user-guide/data-migration/capabilities/field-mapping)を参照してください。

### 必須フィールドの欠落

**原因**: 必須フィールドが空です。

**対処**: 必須フィールドに値を入力するか、その行を削除する。

### リレーションが見つかりません

**原因**: 参照しているレコードが存在しません（例: インポートされていない会社のドメイン）。

**対処**:

* まず親レコードをインポートする
* または参照値を修正する

正しいインポート順序とレコードの関連付け方法は[リレーションのインポート](/l/ja/user-guide/data-migration/capabilities/import-relations)を参照してください。

## エラーを減らすためのヒント

1. **テンプレートをダウンロード**して、ファイルをインポートする前に期待されるフォーマットを確認してください
2. まず**スプレッドシートでデータをクリーンアップ**
3. **正しい順序でファイルをインポート**してリレーションを取り込む（会社 → 人 → 商談）
4. **小さなバッチでテスト**してから全量インポート
5. **アップロード前に重複を確認**
6. **各ファイルを10,000レコードに制限**