Ошибка duplicate key сразу после переноса не означает, что данные «сбились». Частый сценарий проще: строки загрузили с явными ID, а связанная sequence осталась на прежнем значении. Следующий INSERT без ID получил уже занятый номер. До любого setval выясните имя генератора и остановите конкурентные вставки в эту таблицу.
Разница между MAX(id) и last_value — только симптом. Колонка может использовать identity, serial, ручной default, другую schema или вообще не иметь sequence. Кроме того, sequence может идти с increment больше единицы или вниз. Универсальная команда «поставить MAX + 1» без проверки схемы опасна.
Снимок до исправления связывает колонку с генератором
SELECT column_default, is_identity, identity_generation
FROM information_schema.columns
WHERE table_schema = 'public'
AND table_name = 'orders'
AND column_name = 'id';
SELECT pg_get_serial_sequence('public.orders', 'id') AS owned_sequence;
SELECT min(id), max(id), count(*)
FROM public.orders;
SELECT schemaname, sequencename, start_value, min_value, max_value,
increment_by, cycle, last_value
FROM pg_sequences
WHERE schemaname = 'public' AND sequencename = 'orders_id_seq';pg_get_serial_sequence возвращает sequence, связанную с serial или identity-колонкой, и уже формирует имя, пригодное для sequence-функций. Если результат NULL, не угадывайте имя по шаблону: проверьте default, миграции схемы и зависимости. Сохраните вывод до изменения — это исходная точка для отката и разбора.
Одинаковая ошибка возникает по разным причинам
| Наблюдение | Вероятная причина | Следующая проверка |
|---|---|---|
| MAX(id) выше last_value | Явные ID загружены без состояния sequence | Способ переноса и sequence data в dump |
| Sequence совпадает, но INSERT всё равно конфликтует | Приложение пишет явный ID или использует другой default | Фактический SQL и column_default |
| Ошибка только у одного worker | Старая схема, connection pool или кеш ORM | search_path и SQL на этой сессии |
| ID выдаётся из другой схемы | Неуточнённое имя sequence/search_path | regclass и current_schemas(true) |
| После setval конфликт вернулся | Параллельная загрузка или повтор импорта | Активные INSERT и журнал ETL |
| Номера имеют пробелы | Откаты и ON CONFLICT потребляют nextval | Это штатно; sequence не обещает gapless |
Полный pg_dump включает значения sequences в data section по умолчанию. Проблема чаще появляется при выборочном копировании таблиц, INSERT/COPY с явными ID, schema-only restore или самописном ETL. Зафиксируйте точный режим переноса: от него зависит, какие генераторы могли остаться позади.
is_called определяет первый номер после setval
В PostgreSQL setval(sequence, value, true) означает, что следующий nextval сначала увеличит value. При false следующий nextval вернёт ровно заданное value. Для обычной возрастающей sequence с increment 1 и непустой таблицей часто выставляют MAX(id) с true; для пустой таблицы — стартовое значение с false. Это пример, а не команда для всех схем.
-- Выполнять только после проверки параметров sequence
-- и остановки конкурентных INSERT в public.orders.
SELECT setval(
pg_get_serial_sequence('public.orders', 'id'),
(SELECT max(id) FROM public.orders),
true
);
-- Контроль без вставки в рабочую таблицу:
SELECT last_value, is_called FROM public.orders_id_seq;setval виден другим транзакциям сразу и не откатывается вместе с обычным ROLLBACK. Поэтому нельзя считать транзакцию страховкой. Перед изменением запишите прежнее состояние, проверьте min/max/increment/cycle и подготовьте точную обратную команду. Для убывающей sequence сравнение с MAX(id) вообще неверно — нужен нижний край и отрицательный increment.
Окно переключения закрывает гонку с приложением
- Остановить writers или перевести приложение в режим, где таблица не принимает новые заказы.
- Дождаться завершения ETL и повторов из очереди; записать watermark последнего перенесённого объекта.
- Повторить снимок MAX/MIN и состояния sequence в той же базе и schema.
- Выполнить рассчитанный setval для каждой подтверждённой связи колонка–sequence.
- Сделать одну контролируемую вставку штатным путём без явного ID и проверить полученный ключ.
- Возобновить writers постепенно и следить за unique violation и скоростью роста sequence.
Если запись нельзя останавливать, нужен другой протокол: диапазоны ID для источников, новая sequence с переключением default или миграция через логическую репликацию и финальный cutover. Одновременный импорт явных ID и выдача новых значений из того же диапазона не становится безопасным от более частого setval.
Проверка охватывает не одну заметную таблицу
- Составьте список serial и identity-колонок из каталога, а не из памяти команды.
- Сопоставьте каждую sequence с владельцем и фактическим default.
- Отдельно отметьте таблицы, куда импортировал ETL с явным ключом.
- Проверьте дочерние таблицы и partitions: identity наследуется по своим правилам.
- Не требуйте непрерывных номеров — rollback и ON CONFLICT законно оставляют пропуски.
- Добавьте post-migration check до открытия записи приложению.
Автоматическая сверка должна сначала сформировать отчёт и только потом, после одобрения, менять состояние. В отчёте нужны qualified table, column, owned sequence, направление, increment, край данных и предлагаемое значение. Такой dry-run обнаруживает необычную схему до того, как скрипт затронет десятки генераторов.
Успех подтверждает новый штатный INSERT
После переключения создайте тестовую запись тем же API или worker, который падал, не передавая ID. Проверьте, что ключ не занят, foreign keys связались, повтор запроса идемпотентен, а следующий INSERT продолжает последовательность. Затем удалите тестовую бизнес-запись только по утверждённой процедуре — сам выданный номер возвращать в sequence не нужно.
Для разбора подготовьте версии PostgreSQL и инструмента переноса, схему таблицы, column_default, результат pg_get_serial_sequence, параметры pg_sequences, границы ID, команду импорта и время остановки writers. По этим данным можно отличить пропущенное состояние sequence от ошибки маршрутизации в другую базу или schema.