Migration OraToPG » История » Редакция 4
Редакция 3 (BEA, 06.06.2025 13:37) → Редакция 4/5 (BEA, 06.06.2025 13:52)
h1. Миграция с Oracle на PostgreSQL {{>toc}} h2. Миграция на операционной системе Windows h3. Подготовка к миграции: установка необходимого ПО # Установка Perl Скачайте и установите "Strawberry Perl":https://strawberryperl.com/. После установки убедитесь, что Perl добавлен в переменную среды *@PATH@*. Проверьте установку выполнив команду: <pre><code class="shell"> perl -v </code></pre> # Установка Oracle Client. Уже описан процесс в нашей инструкции: [[OracleInstall|ссылка]] # Установка зависимостей Perl ## Откройте командную строку (cmd.exe) от имени администратора и выполните: <pre><code class="perl"> cpan DBI cpan DBD::Oracle cpan DBD::Pg cpan XML::Simple cpan DateTime cpan JSON cpan Term::ReadKey cpan Test::Simple </code></pre> *Для установки модулей может потребоваться доступ в интернет и права администратора.* ## Проверьте установленные зависимости при помощи команд: <pre><code class="shell"> perl -e "use DBI;" perl -e "use DBD::Oracle;" perl -e "use DBD::Pg;" perl -e "use XML::Simple;" perl -e "use DateTime;" perl -e "use JSON;" perl -e "use Term::ReadKey;" perl -e "use Test::Simple;" </code></pre> # Установка ora2pg ## 2 варианта для скачивания ### Перейдите на их "оффициальный сайт":https://ora2pg.darold.net/. Найдите на сайте и перейлите по ссылке "GitHub Download v<version>". Скачиваем архив с исходниками: !clipboard-202506060714-uwsux.png! ### Если у вас установлен git то откройте консоль и перейдите в то местоположение куда хотите скачать. Выполните команду: <pre><code class="shell"> git clone https://github.com/darold/ora2pg.git </code></pre> ## Перейдите в папку с исходниками: <pre><code class="shell"> cd ora2pg </code></pre> Установите: <pre><code class="shell"> perl Makefile.PL dmake dmake install </code></pre> *Примечание:* Если dmake не найден, используйте gmake или nmake (входит в Strawberry Perl). ## Проверка установки <pre><code class="shell"> ora2pg --version </code></pre> Если команда возвращает версию — установка прошла успешно. # Скопируйте @tnsnames.ora@ из вашего рабочего клиента или сервера базы данных Oracle. Подробнее что за файл и откуда брать: [[Oracle|ссылка]] # Проверка подключения к Oracle ## Создайте конфигурационный файл ora2pg.conf используя файл шаблон который можно найти по пути где установлен ora2pg. Пример минимальной конфигурации: <pre> # Set the Oracle home directory ORACLE_HOME <путь ORACLE_HOME куда установлен Oracle клиент> # Set Oracle database connection (datasource, user, password) ORACLE_DSN dbi:Oracle:host=<имя ПК в сети или его IP адрес>;service_name=<TNS имя вашего сервера>;port=<порт> ORACLE_USER <имя пользователся администратора Омеги> ORACLE_PWD <пароль пользователся администратора Омеги> </pre> ## Проверьте соединение с помощью команды: <pre><code class="shell"> ora2pg -t SHOW_VERSION -c /путь/к/вашему/ora2pg.conf </code></pre> или <pre><code class="shell"> ora2pg -c <путь к вашему ora2pg.conf> -e "SELECT * FROM dual;" </code></pre> Если соединение успешно, вы увидите ответ или версию базы данных. h3. Подготовка к миграции: развёртывание PostgreSQL и приведение к одинаковой версии с Oracle # Установить PostgreSQL. Инструкция по установке: [[PostgreInstall|ссылка]] # Произвести импорт стартовой версии БД Omega Production: ## Дамп БД брать из нашего фтп сервера: ftp://demo:demo@internal.omp-system.ru/ServerDistr/DB/omp/dmp/postgres/omp_adm.sql ## Рекомендуется переименовать базу данных в содержимом дампа на ту же что у вас сейчас на оракл. То есть к примеру если у вас пользователь администратор омеги именуется как test_adm то ваша база данных именуется как test_adm. В таком примере необходимо открыть дамп как текстовый файл и заменить по всему файлу OMP_ADM на TEST_ADM. (именно заглавными но в поиске/замене отключаем учитывание регистра) ## Произвести импорт дампа при помощи консольных скриптов описанные в инструкции импорта/экспорта дампа: [[PostgreImportExport|ссылка]] # Выслать отделу сопровождения текущую версию скриптов указанную в окне "О программе" внутри приложения Omega Production и написать чтобы прислали набор скриптов для обновления версии скриптов базы данных # Проверить подключение к базе данных на устройстве на котором ранее устанавливали ora2pg ## Используйте следующую команду для подключения: <pre><code class="shell"> psql -h <имя ПК в сети или его IP адрес> -p <порт> -U <пользователь> -d <имя_базы> </code></pre> Где: - <пользователь> - имя пользователя администратора базы данных - <имя_базы> - такое же как и имя пользователя администратора базы данных При подключении вас попросят ввести пароль. ## Проверка соединения После успешного подключения вы увидите приглашение вида: <pre> <имя базы>=# </pre> Это означает, что соединение установлено. ## Выполнение простых команд для проверки базы ##* Проверка версий PostgreSQL: <pre><code class="sql"> SELECT version(); </code></pre> ##* Проверка содержимого OMP_PROPERTIES: <pre><code class="sql"> SELECT * FROM omp_properties op order by op.code LIMIT 10; </code></pre> ##* Выйти из psql: <pre><code class="sql"> \q </code></pre> # Дождаться ответа от нашего отдела сопровождения и получить набор скриптов для обновления базы данных. ## В наборе скриптов должен присутствовать @run.bat@. Открыть его для редактирования и подправить параметры подключения к базе данных. Содержимое данного скрипта будет из себя представлять уже ранее указанный в этой инструкции @psql ....@ ## Дождаться конца выполнения. Проверить созданный лог на наличие ошибок. Стандартный формат ошибок у PostgreSQL: :ERROR: на английском или :ОШИБКА: на русском в зависимости от выбранного языка при установке СУБД. Если ошибки присутствуют то связаться с нами по вопросу их устранений *ВНИМАНИЕ: после данного этапа необходимо приостановить установку обновлений* h3. Миграция: выгрузка из Oracle # Скачайте указанные ниже файлы из этого вики на ПК где установлен ora2pg и сложите их по одному пути: это вики: #* #* # Отредактируйте файлы указав свои настройки в ниже перечисленных местах <pre> # Set the Oracle home directory ORACLE_HOME <путь ORACLE_HOME куда установлен Oracle клиент> # Set Oracle database connection (datasource, user, password) ORACLE_DSN dbi:Oracle:host=<имя ПК в сети или его IP адрес>;service_name=<TNS имя вашего сервера>;port=<порт> ORACLE_USER <имя пользователся администратора Омеги> ORACLE_PWD <пароль пользователся администратора Омеги> </pre> <pre> # Oracle schema/owner to use SCHEMA <имя пользователя администратора> </pre> h3. Миграция: загрузка в PostgreSQL Если возникнут сложности — предоставьте вывод ошибок, я помогу их интерпретировать!