Переезд с MySQL на PostgreSQL с ModernORMBundle: от mapping до финальной загрузки

От MySQL-схемы до финальной загрузки PostgreSQL через bin/console: генерируем entity, проверяем значения, выбираем правила, проводим репетицию и используем новый --execute из unreleased.

Содержание статьи
  1. 1. Раньше — pgloader. Теперь часть процесса живёт в Symfony
  2. 2. Две команды: от mapping до финальной загрузки
  3. 3. Подготовить версии, подключения и изолированную цель
  4. 4. Получить сущности из MySQL через mapping:import
  5. 5. Адаптировать mapping и подготовить PostgreSQL
  6. 6. Построить план без записи данных
  7. 7. Проверить все строки до загрузки
  8. 8. Описать преобразования как проверяемый JSON
  9. 9. --suggest-rules: выбрать исправления интерактивно
  10. 10. Сохранить журнал преобразований, а не только сводку
  11. 11. --rehearsal: загрузить данные и проверить ограничения
  12. 12. --execute: финальная загрузка в PostgreSQL · unreleased
  13. 13. ManyToMany: переносим связи, а не только сущности
  14. 14. Как читать результат и не спутать попытку с COMMIT
  15. 15. Что пока требует другого решения
  16. 16. Где остаётся pgloader, а где удобен bundle
  17. 17. Что проверить перед финальным переключением
  18. 18. Версия и документация

1. Раньше — pgloader. Теперь часть процесса живёт в Symfony

Раньше для переезда с MySQL на PostgreSQL я использовал pgloader. Он решает понятную задачу: прочитать исходную базу и загрузить данные в PostgreSQL. Но перенос базы не заканчивается копированием строк: приложению нужны mapping, согласованные типы, проверка проблемных значений и воспроизводимый порядок действий.

Сегодня подготовку и репетицию такого переезда можно провести через ModernORMBundle. В beta.6 появились две команды: modernorm:mapping:import для генерации PHP-сущностей и modernorm:data:transfer для планирования, проверки и пробной загрузки. Между ними — явная модель PostgreSQL и правила преобразований, которые можно хранить рядом с кодом приложения.

Разделяем версии: в beta.6 доступны mapping, проверка, правила и --rehearsal. В unreleased добавлен --execute для финальной загрузки, включая настроенную базу приложения. В unreleased также добавлен перенос ManyToMany join tables. Он не переключает приложение на PostgreSQL автоматически: остановка записи и cutover остаются отдельными действиями команды.

Ниже — последовательность от существующей MySQL-схемы до PostgreSQL с проверенными ключами и ограничениями. Примеры рассчитаны на учебную базу users/orders, а не являются командами для немедленного запуска на production.

В исходной MySQL-базе есть составные PK?

Для таких схем в unreleased доступен modernorm:data:transfer --schema-rekey: перенос с назначением новых BIGINT ID, сохранением исходных ключей под UNIQUE и переназначением связей. Подготовку целевой схемы, примеры команд и ограничения разобрали отдельно: «Почему вам не нужны composite PK: один ID, бизнес-ключи и миграция с ModernORMBundle».

2. Две команды: от mapping до финальной загрузки

ЭтапКоманда / режимРезультат
Получить mappingmodernorm:mapping:importEntity с атрибутами ModernORM
Проверить структуруmodernorm:data:transfer --dry-runПлан таблиц, типов, PK/FK, порядка загрузки и блокирующих проблем
Проверить значения--dry-run --validate-dataПолный проход исходных строк без записи в PostgreSQL
Подобрать правила--dry-run --suggest-rulesВыбор правил исправления, сохранение в JSON и повторная проверка данных
Загрузить репетиционную базу--rehearsalРеальные INSERT, проверка ограничений и ключей, настройка sequences, COMMIT
Финальная загрузка · unreleased--executeПроверенная загрузка в явно выбранную PostgreSQL-базу, включая базу приложения

У data:transfer выбирается ровно один режим: --dry-run, --rehearsal или --execute. Последний доступен в unreleased, после beta.6. Обычный dry-run не читает все исходные строки: он строит структурный план. Для проверки содержимого нужен --validate-data; в rehearsal такая проверка обязательна и включается автоматически.

Схему PostgreSQL создаём заранее. Команда переноса не создаёт таблицы, не меняет generated entities и не очищает цель.

Пять этапов подготовки переезда с MySQL на PostgreSQL через ModernORMBundle
Mapping и целевая схема готовятся до проверки и пробной загрузки. Финальный cutover — отдельный этап.

3. Подготовить версии, подключения и изолированную цель

Нужны PHP 8.4+, Symfony 7.4 или 8.x, ModernORMBundle beta.6 для проверки и репетиции либо сборка unreleased с --execute и совместимое ядро ModernORM. Для источника требуется pdo_mysql, для цели — pdo_pgsql. MySQL 8.4 покрыт интеграционными тестами; MariaDB в этот контракт не входит. Для полной проверки значений используем PostgreSQL 17+ с UTF8 и исходные таблицы InnoDB.

В обе CI-матрицы бандла добавлены PHP 8.6 и PostgreSQL 19: основную матрицу и проверку совместимости с ядром beta.5. Это расширение тестовой конфигурации, а не изменение минимальных требований и не обещание ускорения миграции.

composer require 'andreybolonin/modernorm:^0.1.0-beta.5' 'andreybolonin/modernorm-bundle:^0.1.0-beta.6'

Установка выше выбирает опубликованную beta.6 и сама по себе не добавляет --execute. Для финального режима нужна проверенная сборка, включающая commit 1a7f19b, либо последующий релиз с этой возможностью. Поддержка ManyToMany добавлена следующим commit f8f339c и также относится к unreleased. Доступность команды проверьте через php bin/console modernorm:data:transfer --help.

Если bundle ещё не зарегистрирован, добавьте в массив config/bundles.php:

ModernORM\Bundle\ModernORMBundle::class => ['all' => true],

Пример переменных окружения для изолированной разработки. Значения условные; реальные секреты храните в окружении или локальном файле, не в Git.

# Настроенная база приложения остаётся отдельной.
DATABASE_URL=postgresql://app:password@127.0.0.1:5432/catalog_app
MYSQL_DATABASE_URL=mysql://reader:password@127.0.0.1:3306/legacy_catalog
REHEARSAL_POSTGRES_DATABASE_URL=postgresql://loader:password@127.0.0.1:5432/catalog_rehearsal

source-url-env и target-url-env принимают имена переменных, а не сами URL. Команды поддерживают Symfony Dotenv и окружение процесса. MySQL читается через отдельное подключение: это не добавляет поддержку MySQL в runtime ModernORM, который остаётся PostgreSQL-only.

4. Получить сущности из MySQL через mapping:import

php bin/console modernorm:mapping:import \
    --source-url-env=MYSQL_DATABASE_URL \
    --dry-run

# После просмотра PHP и предупреждений — генерация в новый каталог.
php bin/console modernorm:mapping:import \
    --source-url-env=MYSQL_DATABASE_URL \
    --namespace='App\MigrationEntity' \
    --output=src/MigrationEntity

Dry-run показывает PHP и предупреждения, не создавая файлов. Генератор не перезаписывает существующие сущности и не пытается объединить их с новым mapping. Для первой итерации удобно использовать отдельный каталог.

Обычные имена сохраняют множественную форму: users превращается в Users, а не в User. Поддерживаются один скалярный PK, базовые поля, простые индексы и owning ManyToOne для подходящих одноколоночных FK. AUTO_INCREMENT становится IDENTITY.

--table можно повторять, если нужен выборочный импорт mapping. Но для data:transfer это не фильтр переноса: план проверяет все обычные таблицы исходной базы. Каждая обычная таблица должна быть покрыта mapping сущности или owning-side mapping связи ManyToMany. Непокрытые таблицы блокируют перенос, а не пропускаются молча.

Сущность — стартовая модель. Генератор не восстанавливает бизнес-валидацию, lifecycle, inverse collections, ManyToMany, триггеры и все особенности индексов. Mapping ManyToMany нужно подготовить вручную: поддержка загрузки join tables не означает автоматическое восстановление этих связей через mapping:import. Таблицы с составным PK или generated columns могут быть пропущены с предупреждениями; это нужно разобрать до следующего этапа.

5. Адаптировать mapping и подготовить PostgreSQL

В сгенерированном Table schema остаётся имя исходной MySQL-базы. Перед работой с PostgreSQL замените его на целевую схему, например public. Проверьте unsigned, collation, ENUM/SET, выражения defaults и временные поля. Нельзя просто перенести MySQL-специфику в атрибуты и считать PostgreSQL-схему готовой.

# config/packages/modernorm.yaml
modernorm:
    url: '%env(resolve:DATABASE_URL)%'
    server_version: '17' # Фактическая версия PostgreSQL.
    mapping_paths:
        - '%kernel.project_dir%/src/MigrationEntity'

Создайте отдельную catalog_rehearsal и примените к ней проверенную схему. Если используете миграции bundle, их базовый цикл включает modernorm:migrations:diff, migrate --dry-run и migrate; подробнее — в статье о ModernORMBundle. Создание схемы и применение миграций к нужному окружению — отдельный шаг, не часть data:transfer.

Для репетиции нужны те же миграции, extensions, CHECK, UNIQUE, FK и триггеры, которые предполагаются на финальной цели. Entity mapping не описывает все объекты БД. Таблицы для загрузки должны быть пустыми, с теми же физическими именами таблиц и колонок.

Подключение приложения для команды переноса оставьте направленным на catalog_app. Только явный target-url-env указывает на catalog_rehearsal: guard сравнивает имя цели с настроенной базой приложения.

6. Построить план без записи данных

php bin/console modernorm:data:transfer \
    --source-url-env=MYSQL_DATABASE_URL \
    --target-url-env=REHEARSAL_POSTGRES_DATABASE_URL \
    --batch-size=1000 \
    --dry-run

План сопоставляет исходные таблицы, concrete entities и подготовленную цель. Проверяет совпадение одноколоночного PK, типы, обязательные колонки, пустоту таблиц, FK-зависимости и owned sequences. По связям определяется порядок «родитель раньше ребёнка».

Например, users должны загрузиться до orders, если orders.user_id ссылается на users.id. Self-reference, циклы и ссылки за пределы плана в первой версии являются блокерами, а не поводом отключить FK.

Dry-run использует read-only REPEATABLE READ транзакции и завершает их откатом. Он читает metadata и проверяет пустоту цели, но без --validate-data не сканирует значения источника и не считает все строки. Положительный структурный план ещё не доказывает, что каждая дата, строка и сумма совместимы.

batch-size — верхняя граница числа строк, а не гарантия точного размера SQL. Эффективная группа дополнительно ограничивается лимитом PostgreSQL на bind-параметры.

7. Проверить все строки до загрузки

php bin/console modernorm:data:transfer \
    --source-url-env=MYSQL_DATABASE_URL \
    --target-url-env=REHEARSAL_POSTGRES_DATABASE_URL \
    --dry-run --validate-data \
    --batch-size=1000 \
    --max-error-examples=100 \
    --format=json

После структурной проверки команда проходит все исходные строки keyset-батчами по PK, без растущего OFFSET. Проверяются диапазоны чисел, NOT NULL, длины строк, UTF-8 и NUL, boolean 0/1, ENUM/UUID, JSON/JSONB, decimal, нулевые и некорректные даты, дробные секунды и другие поддерживаемые типы.

Одна из типичных проблем — MySQL-дата 0000-00-00 00:00:00. Другая — NULL там, где PostgreSQL ожидает обязательное значение. Третья — значение, которое потребовало бы округления. Инструмент должен сделать такие расхождения видимыми до реальной загрузки.

Лимит max-error-examples ограничивает только сохранённые примеры. Он не прекращает сканирование и подсчёт ошибок; значение 0 оставляет только счётчики. В отчёте есть таблица, PK, колонка и причина без исходных payload значений.

validation.status: complete означает, что проход завершён, а не что данные корректны. Проверяйте error_count, data_scanned и exit code. При структурных блокерах сканирование пропускается. Долгий проход держит снимки БД и требует времени, пропорционального объёму данных.

8. Описать преобразования как проверяемый JSON

Ошибку совместимости нельзя всегда исправить техническим приведением типа. Заменить неизвестную сумму нулём — бизнес-решение. Превратить нулевую дату в NULL допустимо только там, где это разрешает целевая модель.

Правила задаются явно и одинаково применяются при валидации и загрузке. Пример rules.json для учебной схемы:

{
  "version": 1,
  "rules": [
    {"id": "trim_email", "table": "users", "column": "email", "operation": "trim"},
    {"id": "zero_created_at", "table": "users", "column": "created_at", "operation": "replace", "from": "0000-00-00 00:00:00", "to": null}
  ]
}

В примере created_at должен допускать NULL. trim убирает ASCII-пробелы и управляющие пробельные символы по краям, но не обрезает строку до допустимой длины. replace заменяет точное значение. Третья операция, null_to, заменяет только NULL заданным значением, не пустую строку.

Правила выполняются по порядку. Decimal и большие числа записывайте строками; floating-point JSON-аргументы отвергаются. Преобразования PK/FK, binary-колонок, пропуск строк и согласованное переназначение ключей не поддерживаются.

php bin/console modernorm:data:transfer \
    --source-url-env=MYSQL_DATABASE_URL \
    --target-url-env=REHEARSAL_POSTGRES_DATABASE_URL \
    --dry-run --validate-data \
    --rules=var/migration/rules.json

Обычный dry-run с --rules без сканирования проверит привязку правил, но не покажет реальные применения к данным. Для оценки эффекта нужен полный проход.

9. --suggest-rules: выбрать исправления интерактивно

Писать первый JSON вручную необязательно. Режим --suggest-rules сначала полностью проверяет значения, затем предлагает поддерживаемые преобразования:

php bin/console modernorm:data:transfer \
    --source-url-env=MYSQL_DATABASE_URL \
    --target-url-env=REHEARSAL_POSTGRES_DATABASE_URL \
    --dry-run --suggest-rules \
    --rules-output=var/migration/rules.proposed.json

Каталог var/migration нужно создать заранее. Выходной файл должен быть новым: мастер не перезаписывает ни предыдущий результат, ни входной rules.json.

ПроблемаЧто предлагает мастер
Пробелы по краям подходящих текстовых полейtrim
Нулевая дата, а цель допускает NULLТочная замена нулевой даты на NULL
Нулевая дата в обязательной колонкеЯвно введённая пользователем замена
NULL в обязательной колонкеЯвно введённое пользователем значение

Пункт по умолчанию — Skip. Можно отказаться от преобразования и исправить исходную БД или модель вручную. Мастер не угадывает правила дедупликации, смены часовых поясов, переназначения ключей или расширения типов.

После выбора он показывает полный JSON и запрашивает сохранение; ответ по умолчанию — No. Если сохранить файл, команда повторяет полную валидацию в тех же read-only snapshots с новым набором правил. Плохая замена оставит файл для правки, но валидация завершится ошибкой.

Согласие сохранить JSON не означает загрузку данных. Мастер не запускает rehearsal автоматически. Режим требует интерактивного текстового dry-run: он несовместим с --no-interaction, --format=json, --rehearsal, --execute и --change-log. Журнал и реальную пробную загрузку запускаем следующей отдельной командой.

Если уже есть проверенные правила, передайте --rules вместе с --suggest-rules: выбранные новые правила дополнят существующий набор. Предложения опираются на полный проход, а не только на первые сто примеров ошибок.

10. Сохранить журнал преобразований, а не только сводку

php bin/console modernorm:data:transfer \
    --source-url-env=MYSQL_DATABASE_URL \
    --target-url-env=REHEARSAL_POSTGRES_DATABASE_URL \
    --dry-run --validate-data \
    --rules=var/migration/rules.proposed.json \
    --change-log=var/migration/validation-01.jsonl \
    --max-change-examples=100

Отчёт содержит SHA-256 набора правил, счётчики по правилам и ограниченные примеры. Если нужны все затронутые ключи, change-log потоково пишет JSONL: фазу, правило, таблицу, колонку, PK и hash правил. Значения до и после преобразования в журнал не попадают, но сами ключи всё равно требуют аккуратного хранения.

Файл должен быть новым. Журнал содержит начало, изменения и завершение; отсутствие завершающего события означает незаконченный проход. Записи о попытках загрузки могут существовать даже после отката транзакции.

Это аудит применения правил, а не резервная копия и не самостоятельное доказательство COMMIT. Храните его вместе с точным JSON и итоговым отчётом. Не складывайте счётчики validation и rehearsal: это разные проходы тех же данных.

11. --rehearsal: загрузить данные и проверить ограничения

Теперь проводим реальную загрузку в чистую отдельную catalog_rehearsal. Она уже должна содержать проверенную схему и не должна использовать production-каналы внешних действий из триггеров.

php bin/console modernorm:data:transfer \
    --source-url-env=MYSQL_DATABASE_URL \
    --target-url-env=REHEARSAL_POSTGRES_DATABASE_URL \
    --rehearsal --batch-size=1000 \
    --rules=var/migration/rules.proposed.json \
    --change-log=var/migration/rehearsal-01.jsonl \
    --format=json

Rehearsal повторно проверяет структуру и все значения в согласованном read-only снимке InnoDB. Затем загружает ограниченные группы в FK-порядке, сохраняя ID. Target использует одну транзакцию записи, блокирует планируемые таблицы от конкурирующих записей и повторно проверяет их пустоту.

Работают реальные UNIQUE, FK, CHECK и триггеры PostgreSQL. После загрузки команда принудительно проверяет отложенные ограничения, сравнивает число строк и наличие всех исходных PK. INSERT RETURNING помогает выявить подавленные триггером строки и изменённые ключи.

Затем синхронизируются owned PK sequences, чтобы следующий INSERT приложения не пытался повторно использовать перенесённый ID. Для custom/unowned sequences нужна ручная синхронизация. Для ManyToMany загрузка идёт после связанных entity и проверяет полные пары ключей. Проверка ключей и числа строк не является побайтовым сравнением содержимого всех колонок: допустимые изменения неключевых полей триггерами требуют отдельных бизнес-проверок.

Успех заканчивается настоящим COMMIT и оставляет базу для изучения. Повторный запуск в уже заполненные таблицы завершится отказом: автоматического truncate и resume нет.

12. --execute: финальная загрузка в PostgreSQL · unreleased

После успешной репетиции можно использовать новый финальный режим. В отличие от --rehearsal, --execute допускает загрузку в настроенную базу приложения. Цель всё равно указывается явно через target-url-env: команда не выбирает её молча из DATABASE_URL.

Сначала подготовьте пустые целевые таблицы с той же проверенной схемой и правилами. Остановите запись в MySQL и не допускайте трафик приложения и воркеров к цели. Консистентный снимок InnoDB не включает изменения, зафиксированные после его создания; команда не проверяет, действительно ли вы остановили всех писателей.

POSTGRES_DATABASE_URL в примере — отдельная переменная с URL финальной базы. Запускать этот шаг нужно только после подготовки окна переезда:

APP_ENV=prod APP_DEBUG=0 php bin/console modernorm:data:transfer \
    --source-url-env=MYSQL_DATABASE_URL \
    --target-url-env=POSTGRES_DATABASE_URL \
    --rules=var/migration/rules.proposed.json \
    --change-log=var/migration/production-transfer-01.jsonl \
    --batch-size=1000 --execute --format=json

Используется тот же loader, что и в rehearsal: полная проверка значений, правила преобразования, блокировки и проверка пустоты, INSERT RETURNING, ограничения, число строк, исходные PK и owned sequences. --validate-data отдельно не требуется: валидация обязательна. Ничего автоматически не очищается, не обновляется через upsert и не пропускается.

До открытия соединений команда печатает предупреждение о реальной записи, остановке трафика и границах снимка. В обычной Console оно идёт в stderr, чтобы stdout с --format=json оставался JSON. Это предупреждение, а не дополнительное подтверждение: сам --execute разрешает запись в явную цель, в том числе с --no-interaction.

В отчёте будет mode: execute и секция transfer. Успешный результат — transfer.status: committed, transfer.target_data_committed: true и exit code 0. При неопределённом исходе COMMIT значение будет null: исследуйте цель до повторной попытки.

После подтверждённой загрузки проверьте бизнес-результат, переключите подключения штатным процессом деплоя, сбросьте переиспользуемые кеши и перезапустите долгоживущие воркеры перед разрешением записи. Команда не меняет .env, конфигурацию, сервисы или процессы и не модифицирует исходные данные MySQL.

13. ManyToMany: переносим связи, а не только сущности

У пользователей есть роли, у товаров — категории, у документов — метки. Перенести только users и roles недостаточно: связь между ними хранится в user_role. В unreleased ModernORMBundle переносит такие join tables напрямую, без отдельной entity для таблицы связи.

-- Условная таблица связи в исходной MySQL-базе.
-- users и roles имеют обычный одноколоночный PK id.
CREATE TABLE user_role (
    user_id BIGINT NOT NULL,
    role_id BIGINT NOT NULL,
    PRIMARY KEY (user_id, role_id),
    FOREIGN KEY (user_id) REFERENCES users (id),
    FOREIGN KEY (role_id) REFERENCES roles (id)
);

-- Две связи одного пользователя — две самостоятельные строки.
-- Предполагаем, что users.id = 7 и roles.id IN (2, 3) уже существуют.
INSERT INTO user_role (user_id, role_id) VALUES (7, 2), (7, 3);

Это учебная схема, не готовая миграция для вашего проекта. Обе entity и owning-side ManyToMany должны быть описаны в mapping, а соответствующая PostgreSQL-таблица — создана заранее с совпадающими физическими именами, PK и FK. Inverse-side mapping не приводит к повторной загрузке той же таблицы.

Составной курсор сохраняет каждую связь

Один user_id не определяет строку: у пользователя может быть несколько ролей. Загрузка идёт ограниченными порциями с составным keyset-курсором по паре ключей, без глубокого OFFSET. Граница порции учитывает оба значения, поэтому соседние строки одного пользователя не теряются.

Сначала entity, затем таблица связи

Порядок определяется внешними ключами: сначала users и roles, затем user_role. Это позволяет проверять реальные ограничения PostgreSQL, а не переносить связи в обход FK. Ограничения на циклы и ссылки за пределы плана сохраняются.

Проверяем полные пары, а не два списка ID

Недостаточно получить одинаковое число строк и отдельно найти все user_id и role_id. После загрузки проверяется наличие каждой полной исходной пары ключей: (7, 2) и (7, 3) — две конкретные связи. Подмена сочетаний не становится успешной миграцией только потому, что отдельные ID остались в таблице. Это дополняет проверку количества строк и ограничений, но не заменяет прикладную проверку прав пользователей.

Граница поддержки: обе стороны имеют одноколоночные ID, каждая join column ссылается на PK своей entity. Исходная join table содержит ровно две колонки, а в источнике и цели совпадают двухколоночный PK и физические FK. Дополнительные поля связи, неоднозначный mapping и ссылки на не-PK колонки блокируют перенос. Явно заданная схема join table учитывается; по умолчанию — public.

Составной PK такой таблицы связи поддерживается как специальный случай ManyToMany. Entity с составным PK по-прежнему не поддерживаются. Если у связи есть собственные данные, например дата назначения или количество, не стоит автоматически считать её подходящей двухколоночной join table.

Для ManyToMany не нужен отдельный режим команды: подготовьте mapping и схему, проверьте покрытие через --dry-run, затем выполняйте --rehearsal или --execute из сборки с этим изменением. Для механизма добавлены тесты; детали контракта описаны в документации переноса.

14. Как читать результат и не спутать попытку с COMMIT

Поле / результатЧто означает
Exit code 0 в обычном dry-runНет найденных структурных блокеров; полная проверка значений могла не запускаться
data_scanned: trueВсе запланированные исходные строки посещены
validation.status: completeПроход завершён; отдельно проверяем error_count
rehearsal.status: committedПробная загрузка прошла проверку и COMMIT
target_data_committed: trueЗапись целевых данных подтверждена
target_data_committed: nullИсход COMMIT неопределён; сначала исследуем базу

Ошибка останавливает первую проблемную группу; строки не пропускаются молча. При неудачной загрузке rows_loaded может отражать работу внутри откатившейся транзакции, а не сохранённые данные.

Откат таблиц не обещает откат sequence changes или внешних действий триггеров. Поэтому rehearsal — действительно отдельная тестовая база и изолированные внешние подключения. Ошибка финализации журнала после COMMIT тоже требует посмотреть итоговое состояние до повторного запуска.

15. Что пока требует другого решения

СценарийГраница текущей версии
Загрузка в настроенную базу приложенияВ beta.6 запрещена; в unreleased разрешена через явный --execute
Онлайн-переезд с догоняющей репликациейCDC и автоматического cutover нет
Переименование таблиц и колонок при копированииНе поддерживается
Entity с составным PK в исходной MySQL-базеВ unreleased переносятся через --schema-rekey: новый BIGINT ID, исходный ключ под UNIQUE и переназначение FK. Обычный перенос без rekey такие entity не поддерживает; runtime ModernORM использует одиночный ID.
ManyToMany join tablesВ unreleased поддерживаются двухколоночные таблицы связи с составным PK, совпадающими FK и одноколоночными ID обеих entity
Дополнительные поля в join tableНе входят в поддерживаемый двухколоночный формат
Self-reference, циклы FK, ссылки вне планаБлокируют план
Продолжить после ошибки или пропустить плохие строкиResume и row skipping отсутствуют
MariaDB и другие направления переносаНе входят в поддерживаемый контракт

Имя rehearsal-базы должно отличаться от имени настроенной базы приложения даже при другом хосте. postgres и template-базы отвергаются. Этот guard относится к --rehearsal. Для финальной загрузки в базу приложения предназначен --execute из unreleased, а не обход проверки.

Данные сгенерированного mapping ещё не равны перенесённому приложению. Проверяйте SQL-диалект, сравнения строк и collation, часовые пояса, денежные расчёты и поведение транзакций в прикладных сценариях.

Для составных PK entity появился отдельный путь --schema-rekey в unreleased: он назначает surrogate ID и переносит связи, не добавляя composite ID в runtime. Подготовка схемы, проверки и ограничения разобраны в статье о составных ключах и миграции с rekey. Ограничения выше относятся к обычному переносу без этой стратегии.

16. Где остаётся pgloader, а где удобен bundle

pgloader остаётся самостоятельным инструментом загрузки в PostgreSQL: в документации описан перенос MySQL, включая построение схемы и загрузку данных. Он не требует Symfony и решает более общий сценарий. Оснований объявлять его устаревшим из-за появления bundle нет.

ModernORMBundle удобен, когда конечное приложение уже строится на Symfony и ModernORM. Здесь схема-источник становится PHP-mapping, проверки доступны через bin/console, а правила исправлений и отчёты живут рядом с проектом.

ЗадачаЧто выбрать
Нужен самостоятельный перенос БД, без PHP/SymfonyРассмотреть pgloader и его актуальный контракт
Нужны сущности ModernORM из существующей схемыmodernorm:mapping:import
Нужны структурный план, полный scan и JSON-правила в Symfonymodernorm:data:transfer --dry-run
Нужна проверенная пробная загрузка с mapping приложенияmodernorm:data:transfer --rehearsal
Нужно финальное переключение production--execute из unreleased выполняет финальную загрузку; переключение приложения планируется отдельно

Я бы оценивал выбор по схеме и процессу команды, а не по обещанию «одна команда перенесёт всё». В этой статье нет бенчмарка pgloader против bundle и заявления о преимуществе скорости.

17. Что проверить перед финальным переключением

  1. Пройти репетицию на актуальной копии. Те же constraints, extensions, триггеры и правила преобразований.
  2. Проверить бизнес-результат. Не только число строк: суммы заказов, остатки, связи, выборочные документы, поиск и отчёты.
  3. Проверить приложение на PostgreSQL. Чтение, изменение, удаление, новые ID, фоновые задания и обработку ошибок.
  4. Определить окно остановки записи. Успешный scan вчерашнего снимка не включает изменения после него.
  5. Подготовить поддерживаемый способ финальной загрузки. После репетиции используйте --execute из unreleased для явной финальной цели. Опубликованная beta.6 этого режима ещё не содержит.
  6. Зафиксировать переключение и откат. Кто меняет подключения, как проверяется результат и что делать с новыми записями после переключения.

Что получаем уже сегодня: исходная MySQL-база превращается в проверяемый маршрут — mapping, целевая схема, полный scan, согласованные преобразования и реально загруженная PostgreSQL-база для репетиции. В unreleased этот маршрут продолжается финальной загрузкой через --execute. Это существенно сокращает объём собственного одноразового кода для Symfony-проекта.

Для следующего шага полезны возможности ModernORM и подключение bundle, Profiler и миграции.

18. Версия и документация

Материал подготовлен 18 ноября и обновлён 21 ноября 2026 года по ModernORMBundle beta.6 и unreleased до commit f8f339c: --execute, перенос ManyToMany join tables и расширение CI-матриц. Эти unreleased-возможности не следует приписывать опубликованной beta.6. Команды, режим --suggest-rules и ограничения сверены с документацией и реализацией. Примеры SQL-окружения и JSON учебные. Реальную миграцию данных при подготовке этой статьи мы не запускали.

ModernERP Integration Monitor

Узнавайте о сбоях обменов раньше, чем о них сообщат сотрудники

Ошибки, задержки и история обменов между 1С, CRM, WMS и API — в одном сервисе. Контролируйте критичные интеграции с Integration Monitor.

Посмотреть Integration Monitor ↗

Работает на наших серверах · До 15 интеграций · 90 дней истории