---
title: Data Migration
description: Импортируйте и экспортируйте данные вашей CRM через файлы CSV или API.
image: /images/user-guide/import-export-data/cloud.png
---

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

<Frame>
  <img src="/images/user-guide/import-export-data/cloud.png" alt="Миграция данных" />
</Frame>

## Способы импорта

Twenty поддерживает два основных способа импорта данных:

| Метод          | Лучше всего подходит                        | Ограничение объема     |
| -------------- | ------------------------------------------- | ---------------------- |
| **Импорт CSV** | Стандартные миграции, регулярные обновления | 10 000 записей на файл |
| **Импорт API** | Крупномасштабные миграции, автоматизация    | Без ограничений        |

<Note>Для очень больших наборов данных (сотни тысяч записей) используйте API. Наши [партнеры по внедрению](/l/ru/user-guide/getting-started/capabilities/implementation-services) при необходимости помогут запустить эти скрипты.</Note>

## Основы импорта CSV

Вы можете импортировать данные для любого объекта, используя файлы CSV, XLSX или XLS. Каждый файл должен содержать **только один тип объекта** (например, только записи «Люди»).

<Note>**Поля должны существовать до импорта.** Загрузка CSV создает записи, но не создает поля. Если вам нужны настраиваемые поля, сначала создайте их в разделе **Settings → Data Model**.</Note>

### Шаги

1. Перейдите к объекту, в который вы хотите импортировать данные
2. Нажмите значок **⋮** в правом верхнем углу (это Командное меню) и выберите **Импорт записей**
3. Скачайте шаблон файла, чтобы убедиться, что ваши данные в ожидаемом формате
4. Загрузите подготовленный файл CSV
5. Сопоставьте ваши столбцы с полями Twenty
6. Просмотрите ошибки (выделены желтым) и исправьте их, редактируя прямо в интерфейсе
7. Подтвердите импорт

### Импорт связей между объектами

Вы можете импортировать связи между объектами с помощью функции импорта CSV. Вам нужно ссылаться на связанный объект, используя уникальное поле этого объекта: `id`, `email` для «Люди» и участников рабочего пространства, `domain` для компаний, либо любое другое поле, помеченное как уникальное в модели данных для любого другого объекта.

<Note>**Удаленные записи учитываются при проверке уникальности.** Мягко удаленные записи (видны в Командном меню → See deleted records) включаются в проверки уникальности. Если вы импортируете запись с тем же уникальным значением, что и у удаленной записи, удаленная запись будет восстановлена.</Note>

<Warning>
  **Порядок импорта имеет значение!**

  При импорте связанных объектов загружайте файлы в следующем порядке:

  1. Сначала **Компании** (сторона «один» в отношениях)
  2. **Люди** во вторую очередь (связаны с компаниями через companyId)
  3. **Возможности** в третью очередь (связаны с компаниями/людьми)
  4. **Пользовательские объекты** со связями — в последнюю очередь

  Почему? Сторона «один» в связи типа «один-ко-многим» должна существовать, прежде чем вы сможете на нее ссылаться. Например, запись компании должна существовать до импорта человека с идентификатором этой компании.
</Warning>

Обратитесь к [этой статье](/l/ru/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) за пошаговым руководством.

## Экспорт данных

Экспортируйте данные вашего рабочего пространства для резервного копирования, отчетности или миграции.

### Шаги

1. Перейдите к объекту, который вы хотите экспортировать
2. Настройте представление с нужными столбцами
3. Нажмите **⋮** → **Экспортировать представление**
4. Сохраните файл CSV

<Note>**Экспортируются только видимые столбцы.** Файл CSV будет содержать только столбцы, отображаемые в вашем текущем представлении. Добавьте или скройте столбцы перед экспортом, чтобы управлять тем, какие данные будут включены.</Note>

<Note>**Ограничения экспорта**: до 20 000 записей за один экспорт.</Note>

## Разрешения

Импорт и экспорт данных требуют определенных разрешений:

* **Импорт**: требуется разрешение "Import CSV"
* **Экспорт**: требуется разрешение "Export CSV"

Свяжитесь с администратором вашего рабочего пространства, если у вас нет этих разрешений.

## Следующие шаги

* [Подготовьте файлы CSV](/l/ru/user-guide/data-migration/how-tos/prepare-your-csv-files)
* [Импорт связей между объектами](/l/ru/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
* [Импорт через API для больших наборов данных](/l/ru/user-guide/data-migration/how-tos/import-data-via-api)
