Migration d’Oracle vers PostgreSQL

L’extension PostgreSQL pour Visual Studio Code fournit un flux de travail de bout en bout pour migrer des bases de données Oracle vers PostgreSQL. Un Assistant guidé vous guide tout au long de la connexion à votre source Oracle, en sélectionnant des schémas, en configurant un modèle Microsoft Foundry pour la conversion DDL assistée par l’IA et en choisissant une base de données de travail PostgreSQL à des fins de validation. Une fois le projet créé, un tableau de bord effectue le suivi de l’extraction, de la conversion, de l’exportation et de la révision dans une vue unique.

Prerequisites

Avant de commencer, assurez-vous d’avoir :

• Visual Studio Code installé.
• Extension PostgreSQL installée.
• Accès à une base de données source Oracle avec des autorisations de lecture pour l’extraction de schéma.
• Instance PostgreSQL à utiliser comme base de données de validation à zéro (par exemple, un serveur flexible Azure Database pour PostgreSQL).
• Une ressource Microsoft Foundry avec un modèle gpt-5.2 déployé. Vous avez besoin de l’URL du point de terminaison et d’une clé API ou d’un compte Microsoft Entra ID avec accès.

Vérifier que la fonctionnalité de migration est activée

Le pgsql.enableMigrations paramètre contrôle la vue Migrations (préversion) et toutes les commandes de migration. Ce paramètre est activé par défaut.

Si la vue Migrations (préversion) n’apparaît pas dans la barre latérale, vérifiez le paramètre :

1. Ouvrez les paramètres VS Code (Ctrl+, sur Windows/Linux, Cmd+, sur macOS).
2. Recherchez pgsql.enableMigrations.
3. Vérifiez que la valeur est true.

Créer un projet de migration

Un projet de migration est un assistant en quatre étapes qui collecte votre source, votre cible et votre configuration de l’IA avant de créer l’espace de travail du projet.

Étape 1 : configuration de Project

1. Ouvrez la vue Migrations (Aperçu) dans la barre latérale.

2. Sélectionnez le bouton dans la barre d’outils d’affichage ou cliquez avec le + bouton droit sur un dossier d’espace de travail dans l’Explorateur, puis sélectionnez Créer une migration Project.

   La page Nouveau projet de migration d’Oracle vers Azure Database pour PostgreSQL s’ouvre et répertorie les éléments nécessaires :

   • Détails de connexion pour la base de données source
   • Nom du ou des schémas à convertir
   • URL de point de terminaison et clé d’une ressource Microsoft Foundry
   • Nom de connexion pour une instance PostgreSQL existante

3. Entrez un nom dans le champ Nom Project.

4. Sélectionnez Suivant : Connexion Oracle.

Étape 2 : Se connecter à Oracle

La page Se connecter à Oracle collecte vos informations d’identification de base de données source Oracle et vous permet de charger des schémas.

1. Renseignez les champs de connexion Oracle :

   Champ	Description
   Nom d’hôte Oracle	Nom d’hôte ou adresse IP du serveur de base de données Oracle.
   Oracle Port	Port de l’écouteur (par défaut : 1521).
   SID Ou Nom du service Oracle	SiD Oracle ou nom de service pour l’instance de base de données.
   Nom d’utilisateur Oracle	Utilisateur de base de données disposant d’un accès en lecture aux objets de schéma.
   Mot de passe Oracle	Mot de passe de l’utilisateur Oracle.

2. Sélectionnez Charger des schémas pour vous connecter et récupérer la liste des schémas disponibles.

3. Dans la liste déroulante Schémas , sélectionnez un ou plusieurs schémas à migrer.

4. Sélectionnez Suivant : Connexion PostgreSQL.

Étape 3 : Choisissez une base de données de test Azure Database pour PostgreSQL

La page Choisir une base de données de travail Azure Database pour PostgreSQL permet de sélectionner l’instance PostgreSQL utilisée par le modèle d’IA pour valider les fichiers DDL convertis.

1. Dans la liste déroulante Connexion PostgreSQL , sélectionnez un profil de connexion existant. Si la connexion dont vous avez besoin n’est pas répertoriée, sélectionnez Actualiser les profils pour recharger les profils disponibles, ou créez d’abord une connexion dans la vue Connexions et identités .
2. Dans la liste déroulante Base de données PostgreSQL , sélectionnez la base de données cible. Sélectionnez Charger des bases de données si la liste est vide.
3. Après avoir sélectionné une base de données, l’extension vérifie automatiquement que les extensions PostgreSQL recommandées sont installées. Vous pouvez également sélectionner Vérifier les extensions pour exécuter la vérification manuellement. Si des extensions sont manquantes, la page les répertorie et fournit des indications sur leur ajout à la liste d’autorisation et leur installation dans la documentation d’Azure Database pour PostgreSQL – Serveur flexible.
4. Sélectionnez Suivant : Configuration du modèle Microsoft Foundry.

Étape 4 : Configurer le modèle Microsoft Foundry

La page Choisir un modèle Microsoft Foundry configure le déploiement Microsoft Foundry qui alimente le schéma et la conversion de code.

1. Complétez les champs du modèle de langage :

   Champ	Description
   Nom du modèle	gpt-5.2.
   point de terminaison Microsoft Foundry	URL du point de terminaison de la ressource Microsoft Foundry (par exemple, https://<resource>.openai.azure.com/).
   Méthode d'authentification	Choisissez la clé API ou l’ID de Microsoft Entra.
   clé d’API de Microsoft Foundry	Clé API pour la ressource Microsoft Foundry (indiquée lorsque la méthode d’authentification est la clé API).
   Compte Azure	compte Microsoft avec accès à la ressource (indiqué lorsque la méthode d’authentification est Microsoft Entra ID).
   Locataire	Locataire Azure AD du compte (indiqué lorsque la méthode d’authentification est Microsoft Entra Id).
   Nom du déploiement	Nom du modèle déployé dans votre ressource Microsoft Foundry.

2. Sélectionnez Tester la connexion à Microsoft Foundry pour vérifier la connectivité.

3. Sélectionnez Create Migration Project.

Exécuter la migration de schéma

Une fois le projet créé, le tableau de bord Migration Oracle s’ouvre. Le tableau de bord affiche les cartes de migration de schéma et de révision de schéma , ainsi qu’un accordéon Paramètres qui résume la configuration de votre projet.

Extraire et convertir des schémas

La carte Migration de schéma (étape 1) effectue l’extraction, la conversion et l’exportation sous la forme d’un pipeline continu.

1. Sur la carte de migration de schéma , sélectionnez Migrer.

   Le libellé du bouton se met à jour à mesure que le pipeline progresse :

   État	Étiquette du bouton
   Extraction en cours	Extraction en cours...
   Extraction terminée, conversion en attente	Reprendre la migration
   Conversion en cours d’exécution	Conversion en cours...
   Toutes les phases se terminent	Migration terminée

2. Suivez la progression dans la carte étendue :

   • Extraction indique le nombre d’objets extraits (par exemple, « 15 objets extraits sur 42 »), ainsi que le schéma actuel et l’objet en cours de traitement.
   • La conversion montre le nombre de blocs convertis (par exemple, « 3 sur 8 blocs convertis ») et le bloc actuel en cours de traitement.

3. Une fois l’exportation terminée, sélectionnez Afficher le rapport de migration pour ouvrir le rapport de migration généré.

Passer en revue les tâches de migration

La carte de révision de schéma (étape 2) affiche les éléments qui nécessitent une attention manuelle après la conversion. Un sélecteurde tâches / en haut de la zone de révision vous permet de choisir comment parcourir la liste.

Vue groupée

La vue groupée organise les tâches de révision en groupes d’accordéons réductibles par catégorie. Utilisez cette vue lorsque vous souhaitez traiter les problèmes connexes ensemble.

1. Sur la carte Révision du schéma , sélectionnez Révision pour développer l’aire de révision, puis sélectionnez Groupd.

2. Utilisez les onglets en attente et résolus pour basculer entre les tâches qui ont toujours besoin d’attention et de tâches que vous avez déjà approuvées.

3. Développez un groupe pour afficher ses métadonnées (schémas, types d’objets, criticité) et les cartes de tâches individuelles qu’il contient.

4. Utilisez les actions au niveau du groupe pour traiter les tâches en bloc :

   Action	Description
   Exécuter tout	Ouvrez chaque tâche en attente dans le groupe en mode agent Copilot pour une révision assistée par l’IA.
   Résoudre tout	Marquer toutes les tâches du groupe comme résolues. Une boîte de dialogue de confirmation affiche le nom du groupe et le nombre de tâches avant de continuer.
   Réinitialiser tout	Retourne toutes les tâches résolues dans le groupe à l’état en attente. Disponible sous l’onglet Résolu .
   Afficher dans les tâches	Basculez vers la vue à plat Tâches filtrée sur ce groupe.

5. Pour agir sur une seule tâche au sein du groupe, sélectionnez Exécuter la tâche pour l’ouvrir en mode agent Copilot, ou sélectionnez Résoudre pour la marquer comme terminée. Sélectionnez Réinitialiser sur une tâche résolue pour la renvoyer à l’état en attente.

Vue des Tâches

La vue Tâches affiche toutes les tâches de révision dans une table plate. Utilisez cette vue lorsque vous souhaitez trier, filtrer ou rechercher dans toutes les tâches, quel que soit le groupe.

1. Sélectionnez Tâches dans le sélecteur.
2. Utilisez les listes déroulantes de filtre (État, Critique, Type d’objet, Schéma) pour affiner la liste des tâches.
3. Sélectionnez Exécuter la tâche sur un élément en attente pour l’ouvrir en mode agent Copilot pour la révision et la correction assistées par l’IA.
4. Après avoir corrigé un élément, sélectionnez Résoudre pour le marquer comme terminé.

Migrer le code d’application

Après la migration de schéma, convertissez le code d’application spécifique à Oracle (scripts SQL, procédures stockées, fichiers de contrôle du chargeur, scripts shell ou fichiers Java) en équivalents compatibles PostgreSQL. La migration d’applications est une fonctionnalité en préversion.

Choisir une méthode de migration

L’extension offre deux chemins d’accès pour la migration du code d’application :

• Modernisation complète des applications : si l’extension de modernisation application Copilot GitHub est installée, sélectionnez Migrer à l’aide de la modernisation de l’application pour poursuivre la migration avec des notes de codage à partir de la conversion de schéma. Sélectionnez Afficher les notes de codage pour passer en revue les instructions générées avant de continuer.
• Option de base de données uniquement : pour convertir uniquement le code d’application lié à la base de données dans cette extension, sélectionnez Migrer à l’aide de l’extension PostgreSQL.

Convertir le code d’application dans l’extension

1. Sur la carte Migration d’application , sélectionnez Migrer des données (ou Sélectionnez la méthode si l’extension de modernisation de l’application est détectée).
2. Dans la page Convertir l’application , sélectionnez Sélectionner l’application Oracle à convertir et choisissez le dossier qui contient le code de l’application Oracle.
3. Sélectionnez une connexion PostgreSQL et une base de données PostgreSQL pour le contexte de conversion.
4. Sélectionnez Charger des bases de données si la liste de bases de données est vide.
5. Sélectionnez Convertir l’application pour démarrer la conversion.

Utiliser les outils Copilot pour la migration d’applications

L’extension enregistre deux outils de modèle de langage de Copilot pour faciliter la migration :

• Oracle Client Code Application Converter (pgsql_migration_oracle_app) — Convertit le code applicatif client Oracle en équivalents pour PostgreSQL à l’aide de modèles de prompts et de recommandations de codage issues de l’analyse de migration de schéma. Accepte les paramètres suivants :

  • Dossier Codebase d’application (obligatoire) : emplacement du code à convertir.
  • Chemin d’emplacement des notes de codage (facultatif) : chemin d’accès aux notes de codage à partir de la migration du schéma.
  • Nom de la base de données Postgres (facultatif) : nom de la base de données PostgreSQL pour le contexte de conversion.
  • Connexion Postgres DB (facultatif) : nom de connexion pour la base de données PostgreSQL.

• Afficher Oracle vers Postgres Migration Report (pgsql_migration_show_report) : affiche le rapport de migration généré par la conversion de schéma. Nécessite un chemin d’accès au paramètre Fichier de rapport .

Pour plus d’informations sur l’utilisation d’outils Copilot, consultez Copilot intégration.

Comparer les fichiers convertis

Après la conversion, passez en revue les modifications côte à côte à l’aide des commandes diff intégrées.

1. Dans l’Explorateur, cliquez avec le bouton droit sur un fichier SQL converti sous le ou le oracle dossier du projet de migration, puis sélectionnez postgres.
2. Pour les fichiers de code d’application convertis (, , , .sqlou .ctl), cliquez avec le bouton droit sur le fichier, puis sélectionnez .sh. .load.java

La vue de différences côte à côte affiche la source Oracle d’origine en même temps que la sortie PostgreSQL convertie. Vous pouvez donc identifier tous les artefacts qui nécessitent un ajustement manuel.

Gérer les projets de migration

Utilisez la vue Migrations (préversion) dans la barre latérale pour gérer vos projets :

Contenu connexe

• intégration de Copilot
• Connexions et identités
• Informations de référence sur les paramètres
• informations de référence sur les outils Copilot