---
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. **Указывайте уникальные поля**, если хотите обновлять существующие записи
