upstream-twenty/packages/twenty-docs/l/ja/user-guide/data-migration/how-tos/export-your-data.mdx

---
title: データをエクスポート
description: Twenty からデータをエクスポートするための完全なステップバイステップガイド。
---

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

## 概要

バックアップ、レポート作成、または移行のために、ワークスペースのデータを CSV にエクスポートします。

**ユースケース：**

* **定期的なバックアップ** — データのコピーを保持
* **外部レポーティング** — Excel、Google スプレッドシート、BI ツールでデータを分析
* **移行** — データを別のシステムに移す
* **一括更新** — エクスポートして編集し、再インポートしてレコードを更新

## 知っておくべきこと

### エクスポートの制限

* 1 回のエクスポートにつき **最大 20,000 件のレコード**
* **表示されている列**のみがエクスポートされます
* **フィルターで絞り込まれたレコード**のみがエクスポートされます（現在のビューに基づきます）

<Note>大規模なエクスポート（20,000 件超）では、フィルターを使ってバッチに分けてエクスポートするか、[API](/l/ja/developers/extend/api) を使用してください。</Note>

### 権限

データをエクスポートするには **"Export CSV"** 権限が必要です。 このオプションがない場合は、ワークスペース管理者に連絡してください。

## ステップ 1：対象オブジェクトに移動

エクスポートしたいオブジェクトに移動します：

* **People** — 連絡先
* **Companies** — 組織
* **Opportunities** — 商談
* **カスタムオブジェクト** — 作成した任意のオブジェクト

## ステップ 2：ビューを設定

**重要:** エクスポートには現在のビューで表示されているもののみが含まれます。

### 列の追加/削除

1. **Options → Fields** をクリックします（または列の末尾の **+** をクリックします）
2. エクスポートしたいフィールドにチェックを入れる
3. 不要なフィールドのチェックを外す

### レコードをフィルター（任意）

データの一部だけが必要な場合：

1. **Filter** をクリックします
2. フィルター条件を追加します（例："Created date > January 1, 2024"）
3. 条件に一致するレコードのみがエクスポートされます

### レコードを並べ替え（任意）

1. 列ヘッダーをクリックして並べ替えます
2. エクスポートは並べ替え順に従います

<Note>**エクスポート専用のビューを作成しましょう。** エクスポート用に設定したビューを保存しておくと、毎回再設定する必要がありません。</Note>

## ステップ 3：データをエクスポート

1. テーブル右上の **⋮** アイコンをクリックします
2. **Export view** を選択します
3. CSV ファイルの保存場所を選択します
4. ダウンロードの完了を待ちます

## エクスポートされる内容

| 含まれるもの            | 含まれないもの          |
| ----------------- | ---------------- |
| 表示されているすべての列      | 非表示の列            |
| 現在のフィルターに一致するレコード | フィルターで除外されたレコード  |
| カスタムフィールドの値       | ビューに含まれていないフィールド |
| レコード ID           | 添付ファイル           |
| リレーション ID         | 画像               |

### リレーションフィールド

リレーション ID はリレーションシップの **"many" 側** でのみエクスポートされます：

* **People のエクスポート** には `companyId` 列が含まれます（People → Company のリレーション）
* **Companies のエクスポート** には `peopleIds` は含まれません（Companies は "one" 側です）

つまり、People のエクスポートを使用して再インポートすれば Company とのリンクを維持できますが、関係を再作成するには Companies の後に People を再インポートする必要があります。

## 目的別のエクスポート

### バックアップの場合

1. **すべてのフィールド** を表示したビューを作成
2. すべてのフィルターを解除して全レコードを含める
3. 各オブジェクトタイプを個別にエクスポート
4. エクスポートファイルを安全な場所に保管
5. 定期的なリマインダーを設定（毎週/毎月）

### 外部レポーティングの場合

1. 分析に必要なフィールドのみを含める
2. フィルターを適用して関連データに絞り込む
3. 分析対象のフィールドで並べ替えることを検討

### 一括更新の場合

1. 更新したいレコードをエクスポート
2. 一意の識別子（`email`、`domain`、または `id`）を含める
3. エクスポートしたファイルを編集
4. 再インポートしてレコードを更新します
   参照：[既存レコードを更新する方法](/l/ja/user-guide/data-migration/how-tos/update-existing-records-via-import)

### マイグレーションの場合

別のシステムへマイグレーションするためにエクスポートする場合：

1. **各オブジェクトを個別にエクスポート** — People、Companies、Opportunities など
2. **ID フィールドを含める** — 関係の維持に役立ちます
3. **フィールドのマッピングを文書化** — Twenty のフィールドが対象システムにどのように対応するかを記録

## 大規模データセットの扱い（20,000 件超）

エクスポートの上限は 20,000 件です。 より大きなデータセットの場合：

### オプション 1：バッチでエクスポート

1. フィルターを追加（例："Created date" の範囲）
2. 最初のバッチをエクスポート
3. フィルターを変更
4. 次のバッチをエクスポート
5. スプレッドシートでファイルを結合

**バッチ分割の例となるフィルター：**

* 日付範囲別（1月、2月、3月...）
* 担当者別（チームメンバー A、チームメンバー B...）
* ステータス別（Active、Inactive...）

### オプション 2：API を使用

API にはレコード数の上限がありません：

1. **Settings → Developers** から API キーを取得
2. GraphQL API を使用してレコードをクエリします
3. アプリケーションで結果を処理

参照：[API ドキュメント](/l/ja/developers/extend/api)

## ヒントとベストプラクティス

### エクスポート用ビューを作成

エクスポート用に設定したビューを保存します：

1. 列とフィルターを設定
2. **View options** → **Save as new view** をクリック
3. 名前を "Export - [Purpose]" にします

### エクスポートを安全に管理

エクスポートされたファイルには機密データが含まれる場合があります：

* 安全な場所に保管する
* 不要になった古いエクスポートを削除する
* エクスポートファイルの共有に注意する

### エクスポート前の確認

<Check>正しい列が表示されている</Check>
<Check>フィルターが正しく設定されている（または全件エクスポートのために解除済み）</Check>
<Check>エクスポート権限がある</Check>

## FAQ

<AccordionGroup>
  <Accordion title="エクスポートに一部の列が含まれていないのはなぜですか？">
    表示されている列のみがエクスポートされます。 エクスポート前に **Options → Fields** から必要な列を追加してください。
  </Accordion>

  <Accordion title="エクスポートにすべてのレコードが含まれないのはなぜですか？">
    フィルターを確認してください。 エクスポートには、現在のビューのフィルターに一致するレコードのみが含まれます。 すべてのレコードをエクスポートするにはフィルターを解除してください。
  </Accordion>

  <Accordion title="20,000 件を超えるレコードをエクスポートできますか？">
    1 回のエクスポートではできません。 フィルターを使ってバッチに分けてエクスポートするか、より大きなデータセットには API を使用してください。
  </Accordion>

  <Accordion title="エクスポートファイルの形式は何ですか？">
    CSV（カンマ区切り形式）です。 Excel、Google スプレッドシート、その他のスプレッドシートアプリで開けます。
  </Accordion>

  <Accordion title="リレーション ID は含まれますか？">
    はい。ただし、リレーションシップの "many" 側のみです。 たとえば、People のエクスポートには `companyId` が含まれますが、Companies のエクスポートには People の ID は含まれません。
  </Accordion>

  <Accordion title="エクスポートを自動化できますか？">
    UI から直接はできません。 API を使用して自動エクスポートのワークフローを構築してください。
  </Accordion>
</AccordionGroup>

## 次のステップ

* [既存レコードを更新する方法](/l/ja/user-guide/data-migration/how-tos/update-existing-records-via-import) — エクスポートを編集して再インポート
* [API でデータをインポートする方法](/l/ja/user-guide/data-migration/how-tos/import-data-via-api) — 大規模データセット向け
* [API ドキュメント](/l/ja/developers/extend/api) — カスタムのエクスポートワークフローを構築