Migration OraToPG » История » Редакция 3
Редакция 2 (BEA, 06.06.2025 07:36) → Редакция 3/9 (BEA, 06.06.2025 13:37)
h1. Миграция с Oracle на PostgreSQL h2. Миграция на операционной системе Windows h3. Подготовка к миграции: установка необходимого ПО # Установка Perl Скачайте и установите "Strawberry Perl":https://strawberryperl.com/. После установки убедитесь, что Perl добавлен в переменную среды *@PATH@*. Проверьте установку выполнив команду: <pre><code class="shell"> perl -v </code></pre> # Установка Oracle Client. Уже описан процесс в нашей инструкции: [[OracleInstall|ссылка]] (Опционально) Создайте переменную среды TNS_ADMIN и укажите путь к файлу tnsnames.ora, если он используется. # Установка зависимостей 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 клиент> клиент (к примеру @C:\app\product\12.1.0\dbhome_1@)> # Set Oracle database connection (datasource, user, password) ORACLE_DSN dbi:Oracle:host=<имя ПК в сети или его IP адрес>;service_name=<TNS имя вашего сервера>;port=<порт> ORACLE_USER <имя пользователся администратора Омеги> omsk_adm ORACLE_PWD <пароль пользователся администратора Омеги> omsk_adm </pre> ## # Конфигурация для подключения к Oracle ORACLE_DSN = dbi:Oracle:host=oracle_host;sid=ORCL;port=1521 ORACLE_USER = your_oracle_username ORACLE_PWD = your_oracle_password 2.2. Проверьте соединение с помощью команды: <pre><code class="shell"> bash Копировать код ora2pg -t SHOW_VERSION -c /путь/к/вашему/ora2pg.conf </code></pre> или bash <pre><code class="shell"> Копировать код ora2pg -c <путь к вашему ora2pg.conf> /путь/к/вашему/ora2pg.conf -e "SELECT * FROM dual;" </code></pre> Если соединение успешно, вы увидите ответ или версию базы данных. h3. Подготовка к миграции: развёртывание PostgreSQL и приведение к одинаковой версии с Oracle # Установить PostgreSQL. Инструкция по установке: [[PostgreInstall|ссылка]] # Произвести импорт стартовой версии БД Omega Production: 2.3. Логика проверки: ## Дамп БД брать из нашего фтп сервера: 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 и написать чтобы прислали набор скриптов для обновления версии скриптов базы данных Получение ожидаемых данных. # Проверить подключение 3. Проверка подключения к базе данных на устройстве на котором ранее устанавливали ora2pg PostgreSQL ## Используйте следующую команду для подключения: <pre><code class="shell"> psql -h <имя ПК в сети 3.1. Создайте конфигурационный файл ora2pg.conf или его IP адрес> -p <порт> -U <пользователь> -d <имя_базы> используйте параметры командной строки. </code></pre> Пример минимальной конфигурации: ini Где: Копировать код - <пользователь> - имя пользователя администратора базы данных - <имя_базы> - такое же как и имя пользователя администратора базы данных При подключении вас попросят ввести пароль. ## Проверка соединения После успешного # Конфигурация для подключения вы увидите приглашение вида: к PostgreSQL <pre> PG_DSN = dbi:Pg:dbname=your_db;host=postgres_host;port=5432 <имя базы>=# PG_USER = your_postgres_username </pre> PG_PWD = your_postgres_password Это означает, что 3.2. Проверьте соединение установлено. командой: ## Выполнение простых команд для проверки базы bash ##* Проверка версий PostgreSQL: Копировать код <pre><code class="sql"> ora2pg -t SHOW_VERSION -c /путь/к/вашему/ora2pg.conf SELECT version(); или выполните простую команду: bash </code></pre> Копировать код ##* Проверка содержимого OMP_PROPERTIES: ora2pg -c /путь/к/вашему/ora2pg.conf -e "SELECT version();" <pre><code class="sql"> Если соединение успешно, вы увидите версию PostgreSQL. 4. Общие рекомендации SELECT * FROM omp_properties op order by op.code LIMIT 10; Убедитесь, что драйверы установлены и доступны. </code></pre> Проверьте сетевое подключение (ping, telnet) до серверов. ##* Выйти из psql: Внимательно изучите вывод ошибок — они подскажут причину проблем. <pre><code class="sql"> Для диагностики можно включить подробный лог: \q ini </code></pre> Копировать код # Дождаться ответа от нашего отдела сопровождения и получить набор скриптов для обновления базы данных. ## В наборе скриптов должен присутствовать @run.bat@. Открыть его для редактирования и подправить параметры подключения к базе данных. Содержимое данного скрипта будет из себя представлять уже ранее указанный в этой инструкции @psql ....@ LOG_LEVEL = DEBUG ## Дождаться конца выполнения. Проверить созданный лог на наличие ошибок. Стандартный формат ошибок у PostgreSQL: :ERROR: на английском или :ОШИБКА: на русском в зависимости от выбранного языка добавить флаг -v при установке СУБД. запуске. Итог: Если ошибки присутствуют то связаться с нами по вопросу их устранений команды возвращают ожидаемые результаты без ошибок, значит подключение настроено правильно. *ВНИМАНИЕ: после данного этапа необходимо приостановить установку обновлений* h3. Миграция: выгрузка из Oracle # Скачайте указанные ниже файлы из это вики: #* #* # Отредактируйте файлы указав свои настройки в ниже перечисленных местах <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 Если возникнут сложности — предоставьте вывод ошибок, я помогу их интерпретировать!