Работа с результатами конвертации

Трудоемкость проекта миграции зависит от многих параметров — сложности кода, исходных и целевых технологий, языка приложения. Процесс миграции делится на 3 этапа:

1. миграция SQL-кода и данных;
2. тестирование;
3. внесение изменений в приложение, работающее с базой данных.

Уровень конвертации SQL-кода в инструменте Конвертум Мастер очень высок. Кроме того, мы можем оптимизировать программное обеспечение и внести изменения в правила конвертации, исходя их требований каждого проекта. Тем не менее вы должны понимать, что ни один инструмент не может выполнить полностью автоматизированную миграцию базы данных, и любой миграционный проект требует человеческих ресурсов.

В этой статье описаны шаги для успешного выполнения миграции базы данных с помощью Конвертум Мастера. Используя приведенные рекомендации и подсказки, вы можете значительно сократить время ручной корректировки результатов миграции с помощью нашего инструмента.

Инструкции по запуску процесса конвертации с помощью Конвертум Мастера можно найти в Руководстве Пользователя по переносу базы данных. После завершения конвертации и импорта преобразованных объектов вам необходимо выполнить ряд действий, чтобы убедиться в правильности результатов и успешности переноса. Ниже представлен приблизительный план определения текущего уровня результата, поиска ошибок и проверки итоговых данных.

Во-первых, необходимо определить, какой процент объектов был перенесен. В этом вам помогут многочисленные отчеты, которые генерирует наш инструмент после завершения конвертации.

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

С помощью диаграммы вы поймете, сколько объектов было импортировано в базу данных.

Однако наша главная цель — понять, какие объекты не были импортированы и почему. Вы можете:

• открыть соответствующий .log-файл, нажав кнопки “Лог конвертации” или “Лог импорта” (sqlways.log и sqlways_imp.log из директории экспорта);
• открыть отчет о миграции, нажав кнопку “Полный отчет”. Открывшаяся HTML-страница содержит общую информацию обо всех объектах, выбранных для конвертации. Отчет о миграции также можно открыть на странице “Выполнение”, нажав кнопку “Открыть отчет...”:

Собранная информация в отчете отображается в виде карточек:

Нажав кнопки “Просмотреть отчеты” и “Подробнее”, вы откроете следующие более детальные отчеты:

• Отчет о конвертации;
• Отчет об импорте;
• Сводный отчет об ошибках.

Вы также можете открыть .log-файлы конвертации и импорта, нажав кнопки “Просмотреть лог конвертации” и “Просмотреть лог импорта”.

В разделе “Информация об объектах” отчета можно просмотреть данные по каждому типу объекта. Здесь собраны итоговые результаты, но, щелкнув по названию объекта, вы получите более детальную информацию.

Результаты можно изучать в двух режимах: карточки (режим по умолчанию) и список. Для переключения между режимами используйте соответствующие кнопки:

Каждый отчет содержит список объектов с информацией о статусе конвертации. Например, если объект был преобразован с ошибкой импорта, то будет представлен и текст ошибки:

Текст ошибки является ссылкой, по которой вы сможете перейти к месту в логе импорта, соответствующей этой ошибке. Оно будет содержать сообщение из целевой базы данных с информацией о причине ошибки:

Полный список ошибок собран в отчете “Сводный отчет об ошибках”. Здесь представлен список ошибок, количество повторений каждой ошибки и список объектов. Вы также можете проверить каждую ошибку в соответствующем логе:

Эту же информацию можно найти в файлах логов sqlways.log и sqlways_imp.log, которые находятся в директории экспорта, нажав кнопку "Папка экспорта":

Эти логи содержат информацию о процессе конвертации и импорта объектов в целевую базу данных. С их помощью вы можете узнать о каждой конкретной ошибке. Зачастую бывает достаточно проанализировать процесс импорта, поскольку процесс конвертации почти всегда проходит успешно.

Таким образом, благодаря отчетам и журналам вы можете создать список объектов, которые не были сконвертированы, а также определить причины, по которым тот или иной объект не был импортирован. Мы также рекомендуем просмотреть каждый сконвертированный файл, поскольку в них могут содержаться не только ошибки, перечисленные в логе импорта.

Все эти отчеты находятся в директории экспорта, который вы можете открыть, нажав кнопку "Папка экспорта", в папке “reports”. Если вы хотите показать нам отчеты со списком проблем, пожалуйста, предоставьте нам файл data.js из этой папки, а также файлы логов sqlways.log и sqlways_imp.log из папки "Export":

Дальнейший ход работы зависит от текущего уровня конвертации и множества других факторов.

Как вы, наверное, знаете, главное преимущество нашего инструмента (помимо высокого уровня миграции) заключается в том, что мы можем легко расширить наш инструмент и добавить новые правила конвертации или другие функции, которые могут увеличить уровень автоматической миграции или изменить изначальные результаты. Например, если вы обнаружите, что после конвертации появилось несколько повторяющихся ошибок, вы можете запросить кастомизацию инструмента. После реализации кастомизации при повторной конвертации все эти ошибки будут устранены и уровень автоматической миграции значительно повысится, тем самым снизится необходимость в ручной корректировке результата. Но если ошибок немного и все они единичные, то нет смысла расширять инструмент. В этом случае команде разработчиков баз данных гораздо проще исправить эти ошибки вручную.

Таким образом, после завершения миграции обычно есть несколько вариантов действий: если позволяют ресурсы или уровень миграции достаточно высок и нет повторяющихся ошибок, то все дальнейшие действия по исправлению кода лучше выполнять на стороне клиента, не запрашивая кастомизацию инструмента. Если вы обнаружите, что текущий уровень конвертации невысок или есть массовые ошибки, или ваших ресурсов недостаточно для ручной корректировки результатов, лучше запросить кастомизацию инструмента. В результате вы достигните более высокого уровня миграции и получите результат, требующий минимальной ручной доводки.

Как только все объекты будут созданы в целевой базе данных, вам необходимо протестировать их и внести изменения в приложение. Если вам нужна помощь в этих процессах, мы также можем вам с этим помочь.

Важно понимать, что при любых обстоятельствах вам необходимо выделить время и ресурсы для выполнения миграции базы данных. Конвертум Мастер не может преобразовать вашу систему мгновенно и без ошибок. Он предназначен для того, чтобы помочь вам и вашей команде настроить процесс миграции, благодаря чему работа по переносу сокращается в несколько раз. А благодаря нашим отчетам и логам вы можете понять, что необходимо более тщательно настроить и скорректировать.

Другие материалы по теме:
Советы и рекомендации