Содержание статьи
- 1. Раньше — pgloader. Теперь часть процесса живёт в Symfony
- 2. Две команды: от mapping до финальной загрузки
- 3. Подготовить версии, подключения и изолированную цель
- 4. Получить сущности из MySQL через mapping:import
- 5. Адаптировать mapping и подготовить PostgreSQL
- 6. Построить план без записи данных
- 7. Проверить все строки до загрузки
- 8. Описать преобразования как проверяемый JSON
- 9. --suggest-rules: выбрать исправления интерактивно
- 10. Сохранить журнал преобразований, а не только сводку
- 11. --rehearsal: загрузить данные и проверить ограничения
- 12. --execute: финальная загрузка в PostgreSQL · unreleased
- 13. ManyToMany: переносим связи, а не только сущности
- 14. Как читать результат и не спутать попытку с COMMIT
- 15. Что пока требует другого решения
- 16. Где остаётся pgloader, а где удобен bundle
- 17. Что проверить перед финальным переключением
- 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 до финальной загрузки
| Этап | Команда / режим | Результат |
|---|---|---|
| Получить mapping | modernorm:mapping:import | Entity с атрибутами 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 и не очищает цель.
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_rehearsalsource-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/MigrationEntityDry-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=jsonRehearsal повторно проверяет структуру и все значения в согласованном 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-правила в Symfony | modernorm:data:transfer --dry-run |
| Нужна проверенная пробная загрузка с mapping приложения | modernorm:data:transfer --rehearsal |
| Нужно финальное переключение production | --execute из unreleased выполняет финальную загрузку; переключение приложения планируется отдельно |
Я бы оценивал выбор по схеме и процессу команды, а не по обещанию «одна команда перенесёт всё». В этой статье нет бенчмарка pgloader против bundle и заявления о преимуществе скорости.
17. Что проверить перед финальным переключением
- Пройти репетицию на актуальной копии. Те же constraints, extensions, триггеры и правила преобразований.
- Проверить бизнес-результат. Не только число строк: суммы заказов, остатки, связи, выборочные документы, поиск и отчёты.
- Проверить приложение на PostgreSQL. Чтение, изменение, удаление, новые ID, фоновые задания и обработку ошибок.
- Определить окно остановки записи. Успешный scan вчерашнего снимка не включает изменения после него.
- Подготовить поддерживаемый способ финальной загрузки. После репетиции используйте --execute из unreleased для явной финальной цели. Опубликованная beta.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 учебные. Реальную миграцию данных при подготовке этой статьи мы не запускали.