Didacticiel : Conversion d'applications Oracle vers Azure Database pour PostgreSQL - Serveur flexible (version préliminaire)

Ce didacticiel vous guide tout au long de la conversion du code de l’application cliente Oracle en Azure Database pour PostgreSQL à l’aide de l’extension Visual Studio Code PostgreSQL avec GitHub Copilot mode Agent pour automatiser et valider la transformation du code.

Il couvre la configuration de votre environnement, l’importation de votre codebase d’application, l’exécution du processus de conversion et l’examen du code compatible PostgreSQL généré. Avant de commencer, vérifiez que vous avez terminé un projet de conversion de schéma pour obtenir des résultats optimaux.

Voici ce que vous pouvez attendre pendant la conversion :

Configuration de l'environnement : configurez le mode agent GitHub Copilot avec le modèle IA approprié
Importation Codebase : organiser le code de votre application dans la structure du projet de migration
traitement AI : GitHub Copilot traite et convertit le code d’application à l’aide du contexte de base de données
Exécution des tâches TODO : génération et conversion systématique automatisée de la liste des tâches
Génération de rapports : rapport de conversion complet avec des résultats et des recommandations
Comparaison de fichiers : outils de différences intégrés pour examiner le code d’origine et le code converti

Prerequisites

Cette section décrit les pré-requis pour l'utilisation de la fonctionnalité de conversion d'application d'Oracle vers Azure Database pour PostgreSQL dans Visual Studio Code avant de commencer une conversion.

Configuration système requise

Requirement	Spécification
version de Visual Studio Code	1.95.2 ou version ultérieure
abonnement GitHub Copilot	Pro+, Business, Enterprise

Prise en charge du système d’exploitation

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

Exigences relatives au modèle IA

Vous avez besoin de l’un des modèles IA suivants configurés en mode agent GitHub Copilot :

Modèle	Version
Claude	Sonnet 4.6 ou Opus 4.6 ou ultérieur

Avant de commencer la conversion de l’application, définissez votre modèle de mode agent GitHub Copilot sur Claude Sonnet 4.6 ou Claude Opus 4.6 ou ultérieur pour obtenir des résultats optimaux de transformation de code.

Support de version PostgreSQL

Base de données cible	Version
Azure Database pour PostgreSQL – Serveur flexible	PostgreSQL version 15 ou ultérieure
Azure HorizonDB	PostgreSQL version 17 ou ultérieure

Recommandation de conversion de schéma

Bien qu’il ne soit pas nécessaire d’effectuer une conversion de schéma de base de données au préalable, il est fortement recommandé d’effectuer une migration de schéma. Si vous avez déjà converti votre schéma Oracle en PostgreSQL, le processus de conversion d’application fournit des résultats de transformation de code plus précis et de meilleure qualité via :

Notes de codage : Artefacts de métadonnées générés lors de la conversion de schéma (voir Quelles sont les notes de codage ? ci-dessous)
Contexte de base de données : accès direct aux objets de schéma convertis
Mappages de types de données : compréhension précise des transformations de type

Autres prérequis

Connectivité de base de données à votre instance de Azure Database pour PostgreSQL
Accès à la place de marché des extensions de Visual Studio Code et aux services de GitHub Copilot

Qu’est-ce que les notes de codage ?

Les notes de codage sont des artefacts de métadonnées générés automatiquement pendant la phase de conversion de schéma. Ils capturent les détails et les insights de transformation clés de votre conversion de schéma Oracle-to-PostgreSQL que le processus utilise ultérieurement pour améliorer la conversion du code d’application.

Les notes de codage peuvent inclure des informations telles que :

Mappages de types de données et changements structurels
Détails de conversion pour les séquences, les identités et les types composites
Ajustements des implémentations de date/heure ou d’intervalle
Références aux tables avec des contraintes d’intégrité référentielle
Résumés des packages Oracle complexes, y compris les signatures de procédure et de fonction
Indicateurs supplémentaires générés par l’IA pour améliorer la précision de la traduction de code

Pendant la conversion d’application, le modèle IA utilise ces notes comme signaux contextuels pour produire du code compatible PostgreSQL plus précis et sémantiquement aligné.

Processus de conversion d’application

Cette section décrit le flux de travail complet de conversion d’application : configurez votre environnement, importez votre codebase, exécutez la conversion, examinez le rapport généré et comparez les modifications de fichier.

Étape 1 : Configurer votre environnement

Ouvrez Visual Studio Code avec l’extension PostgreSQL installée.
Ouvrez l’interface de conversation GitHub Copilot.
Sélectionnez Claude Sonnet 4.6 ou Claude Opus 4.6 pour le modèle.

L’utilisation de Claude Sonnet 4.6 ou Claude Opus 4.6 est nécessaire pour obtenir des résultats de conversion d’application optimaux. Les modèles inférieurs peuvent produire des conversions moins précises.

Étape 2 : Ouvrir votre projet de migration

Ouvrez l’espace de travail contenant votre projet de conversion de schéma.
Accédez à la structure de dossiers du projet de migration :
```
.github/postgres-migration/project_name/
```
Vérifiez que la structure du projet inclut les dossiers et fichiers nécessaires à partir de la conversion de schéma.

Étape 3 : Copier votre codebase dans le projet de migration

Recherchez le application_code dossier dans votre projet :

.github/postgres-migration/project_name/application_code/

Copiez le dossier codebase que vous souhaitez migrer vers le dossier à l’intérieur application_code de votre dossier de projet.
Organisez les fichiers logiquement pour faciliter la conversion systématique.

Conservez votre code d’application d’origine dans un emplacement distinct en tant que sauvegarde. Copiez uniquement les fichiers que vous souhaitez convertir dans la structure du projet de migration.

Étape 4 : Démarrer la migration du code client

Dans le panneau Migration de l’extension PostgreSQL, sélectionnez Migrer l’application pour démarrer l’Assistant Conversion d’application.
Dans le formulaire qui se charge, sélectionnez le dossier que vous avez copié dans la racine de votre espace de travail.
Choisissez la base de données qui a le contexte de votre application :
- Base de données PostgreSQL où vous avez déployé votre DDL converti ou
- Base de données PostgreSQL où votre schéma d’application existe déjà
Sélectionnez Convertir l’application.

Cette action lance les processus suivants :

Appelle une invite composite personnalisée et un outil en mode Agent
Génère une liste de tâches à faire que le mode Agent continue à traiter
Se connecte et lit votre base de données pour un contexte amélioré
Convertit systématiquement les fichiers de code d’application

Étape 5 : Surveiller la progression de la conversion

Regardez l’interface GitHub Copilot Mode Agent quand elle traite les fichiers.
L’agent fonctionne systématiquement via la liste TODO générée.
Examinez les invites ou les questions de l’agent qui peuvent nécessiter une intervention.
Autorisez le processus de conversion à terminer entièrement avant d’examiner les résultats.

Étape 6 : Conversion améliorée de Java avec GitHub Copilot extension de modernisation des applications (facultatif)

Si vous utilisez Java code : vous pouvez améliorer votre processus de conversion en installant l’extension GitHub Copilot App Modernization avant de commencer votre conversion.

Compilation automatique des tests

Les deux extensions VS Code communiquent entre elles pour fournir une intégration transparente. Lorsque vous convertissez Java code, l’extension de modernisation des applications effectue automatiquement une compilation de test de votre code converti pour identifier les erreurs de syntaxe ou les problèmes de compilation au début du processus.

Génération automatique de tests unitaires

En fonction de votre base de code convertie, l’extension de modernisation des applications génère automatiquement des tests unitaires pour vous aider à vérifier que votre application convertie se comporte correctement. Cette intégration tire parti des fonctionnalités de l’extension de modernisation des applications pour :

Analyser vos classes et méthodes de Java converties
Générer des cas de test appropriés pour les chemins de code critiques
Créer des appareils de test qui fonctionnent avec vos connexions de base de données PostgreSQL

L’installation de l’extension de modernisation des applications GitHub Copilot est vivement recommandée pour les projets de migration Java, car elle accélère considérablement la validation et améliore la qualité de conversion par le biais de vérifications de compilation automatisées et de génération de tests.

Étape 7 : Passer en revue le rapport de conversion de code

Une fois la conversion de l’application terminée en mode Agent, elle génère et ouvre automatiquement un rapport complet.
Le rapport fournit des résultats détaillés et les étapes suivantes recommandées pour votre conversion.

Pour obtenir des directives complètes sur les rapports : Consultez les rapports générés de conversion d'application Oracle vers Azure Database pour PostgreSQL (Aperçu) pour des informations détaillées sur l'interprétation de vos résultats de conversion, la compréhension des statuts de fichiers et la planification de votre stratégie de validation.

Étape 8 : Comparer les modifications de code à l’aide de la fonctionnalité de différences de fichier

Cliquez avec le bouton droit sur un fichier converti (par exemple, un .java fichier) et sélectionnez Comparer les paires de fichiers de migration d’application.
Cela ouvre une vue côte à côte des fichiers d’origine et convertis.
Utilisez-la pour valider les transformations critiques avant de les tester.

Stratégie de comparaison de fichiers efficace : consultez les rapports générés par la conversion d’applications d'Oracle vers Azure Database pour PostgreSQL (préversion) pour obtenir des conseils sur la façon de prioriser les fichiers à examiner en premier et comment concentrer vos efforts de validation.

Étape 9 : Valider le code d’application converti

Étapes de validation essentielles :

Configurer un environnement de test hors production avec votre schéma PostgreSQL converti
Tester la connectivité de la base de données avec les nouvelles chaînes de connexion PostgreSQL
Exécuter des flux de travail métier critiques pour vérifier le comportement de l’application
Valider les résultats de requête SQL par rapport aux résultats attendus d’Oracle
Zones marquées d’un indicateur d’adresse identifiées dans le rapport de conversion

Important

Les systèmes IA peuvent parfois faire des erreurs. Pour éviter les régressions fonctionnelles, les problèmes de sécurité ou les problèmes d’accès aux données, validez indépendamment tout le code d’application converti avant le déploiement en production.

Approche de validation systématique : utilisez les frameworks de validation dans les meilleures pratiques pour convertir le code d’application Oracle en Azure Database pour PostgreSQL (aperçu) pour hiérarchiser les tests en fonction de la complexité de votre intégration Oracle et des résultats de votre rapport de conversion.

Étapes postérieures à la conversion

Une fois la conversion de l’application terminée :

Exécuter des tests unitaires : exécutez la suite de tests de votre application sur le code converti.
Test d’intégration : testez l’application avec votre base de données PostgreSQL.
Test des performances : vérifiez que les performances des requêtes répondent aux exigences.
Révision du code : les membres de l’équipe examinent le code converti pour obtenir une précision.
Mise à jour de la documentation : Mettez à jour toute documentation qui référence des fonctionnalités spécifiques à Oracle.

Stratégies de validation compréhensives : consultez les Meilleures pratiques pour convertir le code d’application Oracle en Azure Database pour PostgreSQL (Préversion) pour des cadres de validation détaillés, des priorités de test et des approches de coordination d'équipe en fonction de la complexité de votre conversion.

Pour plus d’informations sur l’extension Visual Studio Code, consultez l’extension PostgreSQL pour Visual Studio Code

Commentaires

Cette page a-t-elle été utile ?

Dernière mise à jour : 2026-06-08