Passer en revue les objets convertis dans l’Explorateur d’objets de conversion

Utilisez Conversion Explorateur d'objets pour passer en revue et affiner les résultats de conversion Oracle-to-PostgreSQL. L'Explorateur affiche les objets sources ainsi que leurs noms, types et états cibles. Chaque objet ouvre une comparaison entre la source et la cible, avec des actions Copilot permettant d'expliquer la conversion ou d'aider à modifier le fichier PostgreSQL généré.

Pour obtenir des instructions sur l’ouverture de l’Explorateur à partir d’une conversion terminée, consultez Examiner et affiner les objets convertis dans le didacticiel.

Rechercher et inspecter des objets

Utilisez les filtres au-dessus de la table de résultats pour affiner les objets que vous souhaitez examiner :

Contrôle Purpose
Filtrer par nom d’objet source Recherchez un objet par son nom source Oracle.
Tous les schémas Limitez les résultats à un schéma source.
Tous les types d’objets sources Limitez les résultats par type d’objet Oracle.
Tous les statuts Limitez les résultats par les états disponibles pour la conversion.

Lisez ensemble Schéma, le type source et l’objet source pour identifier l’objet Oracle. Comparez Objet cible et Type cible pour comprendre le mappage PostgreSQL. La colonne État affiche le résultat de la conversion de l'objet, et Actions propose les options Demander et Corriger.

Utilisez les contrôles de page sous le tableau lorsque les résultats s’étendent sur plusieurs pages.

Capture d'écran de l'Explorateur d'objets de conversion montrant les filtres d'objets, les mappages entre les sources et les cibles, les états et les actions Demander et Corriger.

Examiner les packages et autres objets contenant plusieurs instructions

Les packages et d’autres objets sources peuvent produire plusieurs instructions PostgreSQL. Dépliez l’objet parent pour inspecter les entrées associées au lieu de traiter la conversion comme une instruction PostgreSQL unique.

Inspecter les membres d'un package

Utilisez la hiérarchie de packages pour parcourir des membres individuels et leurs équivalents PostgreSQL respectifs :

  1. Recherchez le package à l’aide des filtres de schéma et de nom de l’objet source au-dessus de la table principale.
  2. Sélectionnez le chevron en regard du package pour développer la liste de ses membres.
  3. Passez en revue le mappage source à cible de chaque membre, y compris son type de source Oracle et son type de cible PostgreSQL.
  4. Sélectionnez le membre que vous souhaitez inspecter, puis examinez la comparaison entre la source et la cible ainsi que les Notes de conversion.

Examinez chaque membre individuellement pour comprendre les modifications qui lui ont été apportées. Une vue au niveau du package vous permet de localiser les membres, mais ne remplace pas la révision de leurs définitions générées.

Filtrer les membres par type d’objet source

Pour un package avec de nombreux membres, utilisez le filtre de type objet dans le package développé pour vous concentrer sur un type de membre source Oracle à la fois. Le filtre utilise le type de source Oracle du membre, et non son type cible PostgreSQL.

Les deux filtres de type objet servent des objectifs différents :

Emplacement du filtre Ce qu’il filtre
Tous les types d’objets sources au-dessus de la table principale Objets sources dans la liste des résultats principaux.
Filtre de type d'objet dans un package développé Membres de ce package par type d'objet source Oracle.

Après avoir examiné un type de membre, modifiez ou supprimez le filtre de type membre pour passer en revue les membres restants.

Développer et réduire la hiérarchie

Utilisez les commandes Développer tout et Réduire tout au niveau que vous examinez :

Level Purpose
Explorateur Développez ou réduisez simultanément tous les objets pouvant être développés dans l'Explorateur.
Package Développez ou réduisez simultanément tous les membres de ce package.

Utilisez le chevron d’un objet extensible lorsque vous souhaitez uniquement développer ou réduire cet objet.

Comparer les définitions et lire les notes de conversion

Sélectionnez un objet pour ouvrir sa vue de différences. La définition Oracle s’affiche à gauche et la définition PostgreSQL générée s’affiche à droite. Passez en revue la comparaison pour comprendre les modifications apportées aux noms, types, paramètres et constructions spécifiques à la base de données.

Lisez le panneau notes de conversion en même temps que les définitions. Les notes fournissent un contexte sur la conversion et les différences qui nécessitent votre attention. Passez en revue les objets convertis ainsi que les objets qui ont besoin de correction.

Capture d’écran d’une vue de différences Oracle-to-PostgreSQL avec la définition source, la définition générée et le panneau Notes de conversion.

Demandez à Copilot d’expliquer une conversion

Sélectionnez Demander pour un objet afin de demander à GitHub Copilot d'expliquer sa conversion, y compris ses dépendances. Utilisez l’explication avec la vue différentielle et les notes de conversion pour comprendre comment la définition PostgreSQL est liée à la source Oracle.

Passez en revue l'explication de Copilot par rapport aux définitions et aux exigences de votre application avant d'apporter des modifications.

Corriger un objet et compiler des modifications

Corriger ouvre une invite Copilot avec les détails de l'objet. Copilot utilise ce contexte pour apporter des modifications au fichier PostgreSQL. Examinez les modifications obtenues avant de les compiler.

Vous pouvez modifier les fichiers générés avant le déploiement. Pour la compilation manuelle, utilisez une base de données hors production et vérifiez que les schémas et dépendances requis sont disponibles. Si vous devez préparer cette base de données, consultez Setup Experience.

Pour corriger et compiler manuellement un objet dans cette base de données hors production :

  1. Sélectionnez Fix pour l’objet que vous souhaitez modifier.
  2. Collaborez avec Copilot pour apporter les corrections requises et passez en revue la définition PostgreSQL mise à jour.
  3. Ouvrez le fichier PostgreSQL modifié dans l’éditeur SQL.
  4. Connectez l’éditeur SQL au serveur PostgreSQL hors production.
  5. Connectez-vous à la base de données sur ce serveur où le schéma converti est déployé. Vérifiez la base de données active de l’éditeur.
  6. Passez en revue les références de schéma dans sql, puis sélectionnez l’instruction ou les instructions complètes que vous souhaitez exécuter.
  7. Sélectionnez le bouton de lecture dans l’éditeur SQL pour exécuter les instructions sélectionnées et compiler les objets. Vous pouvez également exécuter la sélection avec Exécuter la requête PostgreSQL.
  8. Passez en revue la sortie d’exécution. Corrigez les erreurs signalées et relancez la définition mise à jour si nécessaire.

La commande Exécuter la requête PostgreSQL de l’éditeur SQL exécute le texte sélectionné. Si aucun texte n’est sélectionné, il exécute tout le contenu de l’éditeur. Lorsqu’un fichier contient des définitions pour plusieurs membres convertis, sélectionnez des instructions complètes pour éviter d’exécuter involontairement des définitions non liées.

La modification d'un fichier et sa compilation dans la base de données sont deux étapes distinctes. Utilisez les résultats de l'exécution pour déterminer si la définition mise à jour a été appliquée. Vérifiez que le SQL de déploiement généré inclut les corrections testées avant le déploiement de production ; ne supposez pas que la modification d’un fichier par objet met à jour deploy.sql.

Pour connaître les étapes permettant de connecter l'éditeur, de sélectionner une base de données et d'exécuter du code SQL, consultez Éditeur de requête et IntelliSense.

Valider au-delà de la simple compilation

La compilation réussie n’établit pas que l’objet converti se comporte de la même manière que sa source Oracle. Avant la mise en production, testez indépendamment la gestion des données, la logique métier, les dépendances et le comportement de l’application avec le schéma converti.