Повторяемый импорт и перенос изменений
Импорт запускается на зафиксированном снимке, сохраняет соответствия ключей и выдерживает повтор или перезапуск. Для работающего источника отдельно переносите изменения после снимка.
Плохо
Импортировали напрямую.
Обрыв на середине, глобально очистили цель.
Повтор создал новые товары и письма.
Хорошо
Снимок S, карта полей v3, dry run.
source + type + source_id → target_id.
Пакет и checkpoint сохранены атомарно.
Повтор без изменений → 0 записей.
Дельта после S сверена до переключения.
Почему это важно
Сетевой сбой или падение процесса может возникнуть после сохранения части данных. Импорт без ключей и точки возобновления размножает записи и затирает работу редакторов.
Когда применять
Для программных импортов. Малый статический набор может переноситься одним пакетом с теми же проверками. Для динамических заказов нужен надёжный журнал изменений либо согласованное окно остановки записи.
Требования
- Укажите одну ревизию кода, снимка, справочников и карты полей. Зафиксируйте входные хеши и ключи. Явно ограничьте область записей, которые разрешено менять.
- Сделайте dry run, который считает вставки, обновления, пропуски, удаления и конфликты без записи эффекта. Выполните маленький тестовый пакет в изолированной цели и сверьте результат перед полным прогоном.
- Используйте стабильный уникальный ключ источника или защищённую таблицу соответствий. Сначала загрузите справочники и родители, затем дочерние и связи, либо разрешите зависимости отдельным проходом. Атомарно подтверждайте пакет и позицию продолжения.
- Версионируйте преобразования. Повтор той же версии на том же входе даёт то же состояние. Новые ручные правки защищены сравнением версии и политикой конфликта. Не превращайте отсутствие в неполной выгрузке в удаление.
- Ограничьте пакет, параллелизм и тайм-ауты. Очередь повторов конечна. Запишите ошибки по ключам, обеспечьте повтор проблемной партии. Письма, платежи и вебхуки в тестовом импорте отключены или направлены в тестовые контуры.
- Дельту применяйте по стабильному курсору или журналу событий в согласованном порядке. Учтите удаления, одинаковое время изменений и поздние записи. Если условия непрерывного переноса не подтверждены, согласуйте паузу и выполните новый согласованный снимок.
Кто что делает
Человек
Утверждает, какие изменения цели разрешено перезаписывать и когда переносится дельта.
AI-агент
Реализует dry run, журнал, стабильные ключи, возобновление и сравнение результатов.
Пример применения
Переносятся товары, свойства и медиа. Импорт первого пакета остановлен после сохранения. Повтор распознаёт прежние ключи, продолжает со следующего пакета и сохраняет редакторскую правку как конфликт для решения.
Как проверить у себя
- Имитируйте остановку после записи пакета. Перезапустите: записи, связи и события без дублей, позиция не потеряна.
- Выполните тот же импорт дважды. Сравните контрольные итоги и проверьте сохранение созданной после снимка ручной правки.
- Добавьте, измените и удалите пример в источнике после снимка. Дельта воспроизводит все три результата.
Первоисточники
Дата проверки отражает содержательную сверку. Синхронизация сайта не обновляет её автоматически.