Конвертум Мастер для Windows

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

Весь процесс миграции базы данных выполняется в два этапа:

  • Конвертация. На этапе преобразования инструмент подключается к исходной базе данных с помощью ODBC-соединения, извлекает всю необходимую информацию об объектах, которые были указаны для процесса миграции, и преобразует их. Преобразованный код SQL сохраняется в файлах SQL на локальном компьютере, на котором запущен Конвертум Мастер.
  • Импорт. На этапе импорта Конвертум Мастер подключается к целевой базе данных с помощью клиента целевой базы данных и собственных утилит командной строки (psql.exe, mysql.exe, sqlcmd.exe, sqlplus.exe и другие). С помощью этих утилит, он загружает весь преобразованный SQL-код и извлеченные данные в целевую базу данных.

Поддерживаемые направления миграции

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

Исходная СУБД Целевая СУБД
IBM DB2 LUW
IBM DB2 AS/400 (iSeries)
IBM DB2 OS/390 (z/OS)
Informix
Microsoft SQL Server
MySQL
Oracle
PostgreSQL
Sybase ASE
Sybase ASA
Teradata
Другие...
MariaDB
MySQL
PostgreSQL
Postgres PRO
Teradata
Informix
Microsoft SQL Server
Oracle
Greenplum
Vertica
Другие...

В этом руководстве описывается процесс миграции базы данных с использованием Конвертум Мастер. Руководство основано на конкретном примере миграции базы данных Oracle в Microsoft SQL Server. Для другой миграции базы данных параметры DDL и данных могут отличаться в зависимости от выбранных исходной и целевой баз данных, но настройка и процесс миграции остаются прежними.

Начало работы

Главная страница Конвертум Мастер содержит информацию о проектах, о лицензии и позволяет вам выбрать глобальную папку проекта, в котором будут находиться все проекты, создаваемые при конвертации.

welcome_web

Если ваша версия Конвертум Мастер еще не зарегистрирована, вы увидите соответствующие сообщение при загрузке Конвертум Мастер, а также в карточке "Информация о лицензии".

no_license_msg

В таком случае, пожалуйста, перейдите к главе "Регистрация" и следуйте инструкциям по регистрации инструмента. Если срок действия вашей лицензии истек, пожалуйста, запросите новую на сайте Конвертума.

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

Нажав на кнопку "Создать новый проект", вы сможете создать проект с настройками по умолчанию.

Если проект уже существует, то можно клонировать имеющийся проект с новым именем, но сохранив настройки из существующего:

copy_projec_web

Исходная база данных

На этой странице необходимо выбрать технологию исходной базы данных. Затем выберите метод подключения к исходной базе данных. Доступны два варианта:

  • ODBC-драйвер (только для Oracle, MS SQL Server, SAP ASE, IBM DB2 и IBM Informix)
  • ODBC-соединение

Подключение через ODBC-драйвер

Если выбран метод подключения ODBC-драйвер, необходимо нажать кнопку Выбрать драйвер и выбрать установленный ODBC-драйвер из выпадающего списка доступных драйверов для выбранной технологии исходной базы данных. Если подходящий ODBC-драйвер не установлен, его можно скачать и установить непосредственно из инструмента. Для этого нажмите кнопку Установить драйвер, чтобы открыть окно установки, затем нажмите Установить. Последняя доступная версия драйвера будет загружена и установлена на компьютер. После завершения установки окно автоматически закроется, и можно будет продолжить настройку подключения.

Для подключения к исходной базе данных необходимо указать следующие параметры:

  • Хост
  • Порт
  • Сервис имя (Oracle) / Имя базы данных (MS SQL Server)
  • Системное представление (Oracle)
  • Имя пользователя
  • Пароль После заполнения всех обязательных полей нажмите кнопку Проверить подключение.

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

Примечание: Подключение через ODBC-драйвер в настоящее время доступно только для технологий Oracle, MS SQL Server, SAP ASE, IBM DB2 и IBM Informix. Для остальных технологий можно использовать только ODBC-соединение в качестве метода подключения к исходной базе данных.

odbc_driver_web

Подключение через ODBC-соединение

Если вы выбрали подключение через ODBC-соединение, то вам нужно выбрать соответствующее имя источника данных ODBC (DSN), которое позволит подключиться к базе данных, предназначенной для миграции. Вам также необходимо указать пользователя и пароль для этого подключения, которые будут проверены после нажатия кнопки "Далее >". Для перехода к следующим страницам и дальнейшим шагам миграции должно быть установлено стабильное подключение.

Open Database Connectivity (ODBC) - программный интерфейс доступа (API) к базам данных. Разработчики ODBC стремились сделать его независимым от баз данных и операционных систем. ODBC - это низкоуровневый высокопроизводительный интерфейс, разработанный специально для реляционных хранилищ данных.

Пользователь, указанный на этой странице в поле "Имя пользователя", должен иметь достаточные права для успешного выполнение запроса SELECT из системных таблиц исходной базы данных.

После того, как вы укажете необходимы данные по соединению с исходной базой данной вам необходимо проверить это соединение нажав кнопку "Проверить подключение"

source_connect_check

Целевая база данных

В случае установки успешного подключения к исходной базе данных, на странице созданяи проекта появится блок полей для идентификации целевой базы данных: ее СУБД, сервер и имя самой базы данных, а также пользователя и пароль. Конвертум Мастером будет использовать эта информацию для генерации правильных команд для собственных утилит целевой базы данных (psql.exe, sqlcmd.exe, bcp.exe, mysql.exe, sqlplus.exe и др.).

Указанная целевая база данных и ее схемы должны существовать и быть доступны на момент выполнения операций импорта. Конвертум Мастер не создает целевую базу данных. Целевая база данных заполняется преобразованными объектами.

Далее, то вам необходимо указать свой путь к каталогу Bin(кроме PostgreSQL). Это папка, в которой хранятся собственные утилиты ( sqlcmd.exe, bcp.exe, mysql.exe, sqlplus.exe и др.) целевой базы данных на компьютере, на котором установлен Конвертум Мастер. Это означает, что для выполнения импорта в целевую базу данных вам необходимо установить встроенную утилиту на компьютере, на котором вы выполняете преобразование.

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

В случае успешного прохожения проверки подключения вы можете создать проект, нажав кнопку "Создать проект".

target_database_web

Выбор объектов

В открывшемся проекте вам необходимо указать объекты для преобразования, выбрав их из дерева объектов, извлеченных из исходной базы данных. Чтобы выбрать объекты для переноса, нажмите кнопку "Добавить исходные объекты".

add_obj_tree_web

Выберите объекты для миграции и нажмите кнопку "Применить", после чего выбранные объекты появятся в панели "Миграция проекта".

object_selection_web

В Конвертум Мастере можно изменить выбор объекта для миграции и другие параметры уже после того, как проект преобразования будет запущен.

Для начала выполнения миграции панель с деревом исходных объектов должна быть закрыта.

Настройка

На странице "Настройки" можно изменить параметры преобразования.

Вкладка "Опции" дает возможность добавить или изменить правила преобразования Выбрав секцию, вы можете изменить различные параметры, которые используются для настройки процесса преобразования. settings_1_web

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

settings_2_web

settings_3_web

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

  • разделить миграцию таких объектов, как таблицы, на логические компоненты (DDL, данные, индексы и ограничения), которые можно импортировать в несколько приемов;

import_settings

  • исключить отдельные поля из миграции с помощью флажков;
  • сократить объем экспортируемых данных, используя параметр Data Cut.

data_cut_2

Выполнение

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

Для запуска каждого процесса вы можете выбрать соответствующий пункт в выпадающем списке для кнопки "Начать миграцию".

diff_process_web

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

Если вы хотите просмотреть детальную информацию о процессе перобразования, перейдите на вкладку "Логи".

logs_web

После выполнения конвертации или конвертации и импорта, вы можете открыть объект для редактирования нажав на иконку редактирования. Сконвертированный код появится в редакторе файлов, где вы можете его отредактировать вручную, после чего выполнить импорт именно этого объекта еще раз, нажав кнопку "Импорт".

execution_web

Таким образом, вы можете исправить все объекты, а затем повторно выполнить процесс импорта. После этого можно приступать к тестированию сконвертированного кода.

Все сгенерированные файлы вы можете просмотреть в каталоге экспорта, нажав кнопку открывания папки Проекта в левом нижнем углу. В папке проекта откройте папку "export" со всеми результатами миграции вместе с файлами: convertum.log и convertum_imp.log. В файле convertum.log хранится подробная информация о преобразовании, а в файле convertum_imp.log хранится информация об импорте. Эти файлы могут быть полезны для службы поддержки Конвертум, чтобы понять причины возможных трудностей, с которыми вы можете столкнуться во время миграции, если вы напишете отзыв о работе инструментов Конвертум.

open_project_folder_web

Нажав кнопку "Открыть отчёт", вы откроете отчёт о миграции вашего проекта, где вы сможете изучить подробную информацию о:

  • Процессах экспорта/импорта;
  • Статусе каждого объекта, всех ошибках, которые возникли в процессе миграции;
  • Рекомендациях по устранению ошибок.

Пример отчета конвертации Конвертум Мастер:

report_web

Результат

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

result_web

Дополнительная информация

Если у вас есть какие-либо вопросы или вы столкнулись с трудностями, которые не описаны в данном руководстве, напишите в нашу службу поддержки по адресу support@convertum.ru

Конвертум отличается гибкостью в плане сотрудничества и моделей взаимодействия с Клиентом. Как правило, команда Конвертум использует две модели взаимодействия с клиентами:

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