snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/ru/user-guide/data-migration/capabilities/uniqueness-constraints.mdx

@@ -0,0 +1,72 @@
+---
+title: Ограничения уникальности
+description: Как Twenty обеспечивает уникальность данных при импорте.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Обзор
+
+Twenty обеспечивает уникальность для определённых полей, чтобы предотвратить дублирование записей и обеспечить целостность данных. Понимание этих ограничений важно для успешного импорта.
+
+## Уникальные поля по умолчанию
+
+| Объект                       | Уникальные поля            |
+| ---------------------------- | -------------------------- |
+| **Люди**                     | `id`, `email`              |
+| **Компании**                 | `id`, `domain`             |
+| **Пользовательские объекты** | Только `id` (по умолчанию) |
+
+<Note>Поле `id` — внутренний идентификатор Twenty, автоматически создаётся для каждой записи. Используется формат UUID (например, `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`).</Note>
+
+## Пользовательские уникальные поля
+
+Вы можете задать дополнительные уникальные поля в разделе **Настройки → Модель данных**:
+
+1. Перейдите в **Настройки → Модель данных**
+2. Выберите объект
+3. Нажмите на поле
+4. Включите **Уникальность** в настройках поля
+
+### Сценарии использования пользовательских уникальных полей
+
+* **Внешние идентификаторы**: храните идентификаторы из других систем (Salesforce ID, HubSpot ID)
+* **Бизнес-идентификаторы**: номера сотрудников, коды клиентов
+* **Альтернативные контактные данные**: профиль LinkedIn, номер телефона
+
+<Note>Имя поля `id` зарезервировано для внутреннего идентификатора Twenty. Для внешних идентификаторов используйте другое имя, например `externalId` или `legacyId`.</Note>
+
+## Поведение при импорте
+
+### Создание новых записей
+
+Если значение уникального поля отсутствует, создаётся новая запись.
+
+### Обновление существующих записей
+
+Если значение уникального поля совпадает с существующей записью, эта запись будет **обновлена** новыми данными.
+<Warning>Чтобы **обновлять существующие записи**, рекомендуется **сопоставлять только одно уникальное поле**.</Warning>
+
+### Записи, помеченные как удалённые
+
+<Warning>
+**Записи, помеченные как удалённые, учитываются при проверке уникальности.**
+
+Записи, помеченные как удалённые (видны в Командном меню → Показать удалённые записи), учитываются при проверке уникальности. Если вы импортируете запись с тем же уникальным значением, что и у удалённой записи, удалённая запись будет **восстановлена** с новыми данными.
+</Warning>
+
+## Обнаружение дубликатов при импорте
+
+На этапе проверки:
+
+* Дубликаты в вашем файле подсвечиваются жёлтым
+* Вы можете отредактировать или удалить строки-дубликаты в интерфейсе перед началом импорта
+
+<VimeoEmbed videoId="1145246326" title="Видеодемонстрация" />
+
+## Лучшие практики
+
+1. **Удалите дубликаты** из файла перед импортом
+2. **Проверьте наличие существующих записей** в Twenty перед импортом
+3. **Используйте внешние идентификаторы** при миграции из других систем
+4. **Указывайте уникальные поля**, если хотите обновлять существующие записи