Руководство: преобразование приложений из Oracle в База данных Azure для PostgreSQL — гибкий сервер (предварительная версия)

В этом руководстве описано, как преобразовать код клиентского приложения Oracle в База данных Azure для PostgreSQL с помощью расширения PostgreSQL Visual Studio Code с режимом агента GitHub Copilot для автоматизации и проверки преобразования кода.

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

Вот что можно ожидать во время преобразования:

Настройка среды: настройка режима агента GitHub Copilot с соответствующей моделью ИИ
Импорт базы кода: упорядочение кода приложения в структуре проекта миграции
AI processing: GitHub Copilot обрабатывает и преобразует код приложения с помощью контекста базы данных
Выполнение задачи TODO: автоматическое создание списка задач и систематическое преобразование
Создание отчетов: комплексный отчет о преобразовании с результатами и рекомендациями
Сравнение файлов: встроенные средства диффа для просмотра исходного кода и преобразованного кода

Необходимые условия

В этом разделе описаны предварительные условия для использования функции преобразования приложений из Oracle в Azure Database для PostgreSQL в Visual Studio Code перед началом преобразования.

Системные требования

Требование	Спецификация
Visual Studio Code версия	1.95.2 или выше
подписка GitHub Copilot	Pro+, Business, Enterprise

Поддержка операционной системы

Platform	Architecture
Windows	x64 и ARM64
Linux	x64 и ARM64
macOS	x64 (Intel) и ARM64 (Apple Silicon)

Требования к модели ИИ

Вам потребуется одна из следующих моделей ИИ, настроенных в режиме агента GitHub Copilot:

Модель	Версия
Клод	Соннет 4.6 или Opus 4.6 или более поздняя версия

Перед началом преобразования приложения задайте для модели режима агента GitHub Copilot значение Claude Sonnet 4.6 или Claude Opus 4.6 или более поздней версии, чтобы получить оптимальные результаты преобразования кода.

Поддержка версий PostgreSQL

Целевая база данных	Версия
База данных Azure для PostgreSQL — гибкий сервер	PostgreSQL версии 15 или выше
Azure HorizonDB	PostgreSQL версии 17 или более поздней

Другие необходимые условия

Подключение к вашему экземпляру базы данных Azure Database для PostgreSQL
Доступ к Marketplace расширений Visual Studio Code и службам GitHub Copilot

Что такое заметки по кодированию?

Заметки по коду — это артефакты метаданных, автоматически создаваемые на этапе преобразования схемы. Они фиксируют ключевые детали преобразования и аналитику из преобразования схемы Oracle-to-PostgreSQL, которую процесс затем использует для улучшения преобразования кода приложения.

Заметки по коду могут включать такие сведения, как:

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

Во время преобразования приложения модель ИИ использует эти заметки в качестве контекстных сигналов для создания более точного и семантического совместимого кода PostgreSQL.

Процесс преобразования приложений

В этом разделе описывается полный рабочий процесс преобразования приложений: настройка среды, импорт базы кода, запуск преобразования, просмотр созданного отчета и сравнение изменений файлов.

Шаг 1. Настройка среды

Откройте Visual Studio Code с установленным расширением PostgreSQL.
Откройте интерфейс чата GitHub Copilot.
Выберите Claude Sonnet 4.6 или Claude Opus 4.6 для модели.

Использование Claude Sonnet 4.6 или Claude Opus 4.6 требуется для оптимального преобразования приложений. Более низкие модели могут создавать менее точные преобразования.

Шаг 2. Открытие проекта миграции

Откройте рабочую область, содержащую проект преобразования схем.
Перейдите к структуре папки проекта миграции:
```
.github/postgres-migration/project_name/
```
Убедитесь, что структура проекта включает необходимые папки и файлы из преобразования схемы.

Шаг 3. Копирование базы кода в проект миграции

Найдите папку application_code в проекте:

.github/postgres-migration/project_name/application_code/

Скопируйте папку codebase, которую необходимо перенести в папку application_code проекта.
Логическая организация файлов для облегчения систематического преобразования.

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

Шаг 4. Запуск миграции кода клиента

На панели миграции расширения PostgreSQL выберите "Миграция приложения" , чтобы запустить мастер преобразования приложений.
Когда форма загрузится, выберите папку, скопированную в корневом каталоге вашей рабочей области.
Выберите базу данных с контекстом для приложения:
- База данных PostgreSQL, в которой вы развернули преобразованное DDL или
- База данных PostgreSQL, в которой уже существует схема приложения
Выберите "Преобразовать приложение".

Это действие инициирует следующие процессы:

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

Шаг 5. Мониторинг хода преобразования

Наблюдайте за интерфейсом режима агента GitHub Copilot по мере обработки файлов.
Агент работает с созданным списком TODO систематически.
Просмотрите любые запросы или вопросы от агента, которые могут требовать ввода.
Разрешите процессу преобразования завершиться полностью, прежде чем просматривать результаты.

Шаг 6: Расширенная конвертация Java с плагином GitHub Copilot для модернизации приложений (необязательно)

Если вы работаете с кодом на Java, вы можете улучшить процесс преобразования, установив расширение GitHub Copilot App Modernization Extension перед началом преобразования.

Автоматическая компиляция тестов

Два расширения VS Code взаимодействуют друг с другом, чтобы обеспечить простую интеграцию. При преобразовании кода Java расширение модернизации приложений автоматически выполняет тестовую компиляцию преобразованного кода, чтобы определить все синтаксические ошибки или проблемы компиляции в начале процесса.

Автоматическое создание модульного теста

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

Анализ преобразованных Java классов и методов
Создание соответствующих тестовых вариантов для критически важных путей кода
Создайте тестовые окружения, которые работают с подключениями к базе данных PostgreSQL

Установка расширения GitHub Copilot модернизации приложений настоятельно рекомендуется для проектов миграции Java, так как она значительно ускоряет проверку и улучшает качество преобразования с помощью автоматизированных проверок компиляции и создания тестов.

Шаг 7. Просмотр отчета о преобразовании кода

После завершения преобразования приложения в режиме агента он автоматически создает и открывает полный отчет.
В отчете приведены подробные результаты и рекомендуемые дальнейшие действия по преобразованию.

Для получения полного руководства по отчетам: ознакомьтесь с созданные отчеты по преобразованию приложений Oracle в Azure Database для PostgreSQL (предварительная версия) для получения подробных сведений об интерпретации ваших результатов преобразования, понимания статусах файлов и планировании стратегии валидации.

Шаг 8. Сравнение изменений кода с помощью функции диффа файла

Щелкните правой кнопкой мыши преобразованный файл (например, .java файл) и выберите "Сравнить пары файлов миграции приложений".
Откроется параллельное представление исходных и преобразованных файлов.
Используйте это для проверки критически важных преобразований перед тестированием.

Эффективная стратегия сравнения файлов: ознакомьтесь с Oracle для База данных Azure для PostgreSQL отчетами преобразования приложений (предварительная версия), чтобы понять, какие файлы следует просмотреть в первую очередь и сосредоточить свои усилия на проверке.

Шаг 9. Проверка преобразованного кода приложения

Основные шаги проверки:

Настройка тестовой среды непроизводства с преобразованной схемой PostgreSQL
Проверка подключения к базе данных с помощью новых строк подключения PostgreSQL
Выполнение критически важных бизнес-рабочих процессов для проверки поведения приложения
Проверка результатов SQL-запроса на ожидаемые результаты из Oracle
Устраните помеченные области, выявленные в отчете о преобразовании

Important

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

Подход систематической проверки: используйте платформы для проверки в разделе Лучшие практики преобразования кода приложений Oracle для База данных Azure для PostgreSQL (предварительная версия), чтобы определять приоритеты тестирования на основе результатов отчета о сложности интеграции Oracle и преобразования.

Шаги после преобразования

После завершения преобразования приложения:

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

Полные стратегии проверки: см. лучшие практики по преобразованию кода приложения Oracle в База данных Azure для PostgreSQL (предварительная версия) для детальных схем валидации, приоритетов тестирования, а также подходов к координации команд в зависимости от сложности преобразования.

Дополнительные сведения о расширении Visual Studio Code см. в расширении PostgreSQL для Visual Studio Code

Обратная связь

Были ли сведения на этой странице полезными?

Последнее обновление: 2026-06-08