Qu'est-ce que la conversion de schéma d’Oracle vers Azure Database pour PostgreSQL - Serveur flexible ?

La fonctionnalité de conversion de schéma Oracle vers Azure Database pour PostgreSQL dans l’extension PostgreSQL visual Studio Code vous permet de convertir vos objets de schéma de base de données Oracle existants en schéma compatible Avec PostgreSQL. Cette fonctionnalité est conçue pour les schémas relationnels et produit un schéma converti pour Azure Database pour PostgreSQL serveur flexible.

L’outil fournit une interface utilisateur basée sur un projet pour automatiser la conversion de schéma. Si certains objets ne peuvent pas être convertis automatiquement, l'outil les signale comme tâches de révision, que vous pouvez résoudre manuellement à l'aide de GitHub assistant Copilot mode.

Architecture

Le processus de conversion de schéma implique plusieurs composants travaillant ensemble :

• Base de données Oracle source : votre base de données Oracle existante qui contient le schéma à convertir.
• Visual Studio Code extension PostgreSQL : interface principale pour la gestion du processus de conversion.
• Azure Database pour PostgreSQL - Serveur flexible : héberge les schémas temporaires utilisés pour la validation et les tests.
• Microsoft Foundry : fournit les modèles de langage qui alimentent la transformation de schéma pilotée par l’IA.
• Agents de conversion de schéma : agents basés sur l’IA qui gèrent le processus de conversion automatisé.

Fonctionnement

Le processus de conversion de schéma utilise une approche intelligente et multistage qui combine la transformation automatisée avec la supervision humaine :

• Connexion et découverte : l’outil se connecte à votre base de données Oracle et catalogue tous les objets de schéma. Il analyse sa structure, ses dépendances et sa complexité pour créer un plan de conversion.
• Transformation basée sur l’IA : les agents de conversion de schéma utilisent des modèles de langage hébergés dans Microsoft Foundry pour transformer des constructions spécifiques à Oracle en équivalents compatibles PostgreSQL. L’IA prend en compte les meilleures pratiques de contexte, de relations et de plateforme.
• Validation dans les schémas temporaires : l’outil teste tous les objets convertis dans ces schémas temporaires sur votre serveur flexible Azure Database pour PostgreSQL. Cette étape vérifie l’exactitude et la compatibilité de la syntaxe avant la génération finale de sortie.
• Passer en revue la génération de tâches : l’outil signale les objets qui ne peuvent pas être entièrement automatisés ou qui nécessitent un jugement humain en tant que tâches d’examen. Ces objets peuvent inclure une logique métier complexe ou des fonctionnalités spécifiques à Oracle qui nécessitent une attention manuelle.
• Résolution guidée : le mode assistant Copilot GitHub fournit de l’aide pour effectuer des tâches de révision. Il propose des suggestions contextuelles et des bonnes pratiques de serveur flexible Azure Database pour PostgreSQL pour vous aider à prendre des décisions éclairées.
• Génération de sortie : l’outil convertit les objets validés avec succès en fichiers PostgreSQL .sql organisés, prêts pour le déploiement dans votre environnement cible.

Installer l’extension

La fonctionnalité de conversion de schéma Oracle vers PostgreSQL est intégrée à l’extension PostgreSQL pour Visual Studio Code. Vous n’avez pas besoin d’installer une extension distincte.

Procédure d’installation :

1. Open Extensions Marketplace : dans Visual Studio Code, sélectionnez l’icône Extensions dans la barre d’activité sur le côté gauche, ou utilisez le raccourci clavier Ctrl+Shift+X (Windows/Linux) ou Cmd+Shift+X (macOS).
2. Recherchez l’extension : dans la zone de recherche Extensions Marketplace, entrez PostgreSQL (ou l’ID d’extension ms-ossdata.vscode-pgsql) pour rechercher l’extension.
3. Installer l’extension : dans les résultats de la recherche, recherchez PostgreSQL publié par Microsoft, puis sélectionnez Install. Plusieurs extensions PostgreSQL sont disponibles sur la Place de marché. Vérifiez donc que l’éditeur est Microsoft avant d’installer.
4. Access Schema Conversion : une fois l’extension installée, une icône d’éléphant apparaît dans la barre d’activité Visual Studio Code. Sélectionnez l’icône pour ouvrir l’extension PostgreSQL et accéder à la fonctionnalité conversion de schéma.

Flux de travail de conversion de schéma

Cette section explique les concepts fondamentaux utilisés tout au long du flux de travail de conversion de schéma d’Oracle vers Azure Database pour PostgreSQL, y compris les unités de conversion (schémas, tables, index, vues et procédures), les tâches de révision assurant la supervision humaine, la validation dans une base de données temporaire, les agents de conversion de schéma basés sur l’IA et les artefacts SQL PostgreSQL qui en résultent. La compréhension de ces concepts vous permet d’interpréter les résultats de conversion, de hiérarchiser et de résoudre les éléments marqués d’un indicateur et de préparer les fichiers convertis pour le déploiement vers un serveur flexible Azure Database pour PostgreSQL.

Base de données scratch

L’outil de conversion de schéma utilise un serveur flexible Azure Database pour PostgreSQL comme environnement de validation temporaire. Dans ce serveur, l’outil crée un ou plusieurs schémas de travail, qui sont des schémas PostgreSQL de courte durée qui contiennent des objets convertis afin que l’outil puisse les tester sans affecter vos données de production.

L’utilisation de schémas temporaires à l’intérieur d’une base de données temporaire permet à l’outil de vérifier que :

• Les objets convertis sont syntaxiquement corrects.
• Les dépendances entre les objets sont résolues dans l’ordre correct.
• Les définitions d’objets restent compatibles avec la version cible de PostgreSQL.
• Les fonctionnalités d’Azure Database pour PostgreSQL - Serveur flexible s’appliquent correctement.

Passer en revue les tâches

L’outil signale les éléments de révision manuelle lorsque l’IA ne peut pas convertir entièrement un objet ou recommande de confirmer le résultat. Les tâches courantes de révision sont les suivantes :

• Procédures PL/SQL complexes nécessitant un ajustement manuel.
• Types de données spécifiques à Oracle qui ont plusieurs alternatives PostgreSQL.
• Fonctions personnalisées qui contiennent une logique spécifique à Oracle.

Pour plus d’informations sur la révision des priorités des tâches et les dossiers de sortie générés, consultez Examiner les tâches et les dossiers de sortie d’Oracle pour Azure Database pour PostgreSQL conversion de schéma de serveur flexible.

Mode de l’agent GitHub Copilot

Le mode agent de GitHub Copilot est une fonctionnalité intégrée à Visual Studio Code qui fournit des invites guidées pour vous aider à effectuer des tâches de révision et à aligner le schéma converti sur les exigences de votre application. Offres en mode Agent :

• Suggestions contextuelles pour les modifications de schéma.
• Recommandations de bonnes pratiques pour Azure Database pour PostgreSQL serveur flexible.
• Autocomplétion du code pour les transformations complexes.
• Intégration à votre flux de travail de développement existant.

Modes de connectivité Oracle

L’outil de conversion de schéma prend en charge deux modes de connectivité pour la connexion à votre base de données Oracle source : mince et épais. Comprendre la différence vous aide à choisir le mode approprié pour votre environnement.

Mode client léger (par défaut)

Le mode mince se connecte directement à Oracle Database sans bibliothèques de client Oracle supplémentaires. Ce mode est la valeur par défaut et ne nécessite aucune configuration supplémentaire.

• Nécessite aucune installation du client instantané Oracle.
• Prend en charge Oracle Database 12.1 et versions ultérieures.
• Convient à la plupart des scénarios de conversion de schéma.
• Se connecte à l’aide de la mise en réseau TCP/IP standard.

Mode client épais

Le mode « thick » utilise les bibliothèques Oracle Instant Client pour se connecter à Oracle Database. L’outil de conversion de schéma détecte quand un mode épais est nécessaire en fonction de votre configuration réseau Oracle et bascule automatiquement vers celui-ci.

Lorsque le mode client épais est requis

Vous pouvez déterminer si le mode client épais est requis en vérifiant les fichiers de configuration réseau Oracle dans votre environnement source. Recherchez les paramètres suivants dans le sqlnet.ora fichier (généralement situés dans $ORACLE_HOME/network/admin/) :

Si l’un de ces paramètres est configuré dans votre environnement Oracle source, le mode client épais est requis. L’outil de conversion de schéma détecte cette configuration et bascule automatiquement en mode épais. Vérifiez que le client instantané Oracle est installé sur l’ordinateur où Visual Studio Code est en cours d’exécution avant de démarrer la conversion.

Installer le client instantané Oracle

Pour utiliser le mode client épais, installez Oracle Instant Client sur l’ordinateur où Visual Studio Code et l’outil de conversion de schéma sont en cours d’exécution. La conversion de schéma est prise en charge uniquement sur Windows et Linux .

1. Téléchargez le package Oracle Instant Client Basic ou Basic Light à partir du site web d’Oracle pour votre système d’exploitation.
2. Extrayez le package dans un répertoire sur l’ordinateur.
3. Ajoutez le répertoire Instant Client à la variable d’environnement système PATH :
   • Windows : ajoutez le répertoire Instant Client à la PATH variable via les propriétés système>variables d’environnement ou en utilisant PowerShell.
   • Linux : ajoutez le répertoire Instant Client à PATH et définissez la variable d’environnement LD_LIBRARY_PATH pour inclure le répertoire. Vérifiez que la libaio bibliothèque est installée.
4. Redémarrez Visual Studio Code pour récupérer les variables d’environnement mises à jour.

Authentification pour Microsoft Foundry

L’outil de conversion de schéma prend en charge deux méthodes d’authentification pour la connexion aux modèles de langage dans Microsoft Foundry :

Authentification par clé API

L’authentification par clé API utilise une clé spécifique au déploiement pour autoriser les demandes. Cette méthode est simple et adaptée aux scénarios de développement et de test.

Authentification par Microsoft Entra ID

L’authentification Microsoft Entra ID permet d’accéder à Microsoft Foundry à l’aide de jetons et d’une identité, sans avoir à gérer des clés API. Cette méthode est recommandée pour les environnements de production et les organisations avec la gestion centralisée des identités.

Pour utiliser l’authentification microsoft Entra ID :

1. Assigner le rôle requis : vérifiez que l’utilisateur ou le principal de service connecté a le rôle Foundry User (anciennement Azure AI User) sur la ressource Microsoft Foundry qui héberge votre déploiement de modèle. Attribuez le rôle dans le portail Azure sous Contrôle d’accès (IAM). Pour plus d’informations, consultez Contrôle d’accès en fonction du rôle pour Microsoft Foundry.
2. Connectez-vous à Azure dans Visual Studio Code : utilisez la commande Azure : Se connecter dans la palette de commandes (Ctrl+Shift+P) pour vous authentifier avec votre compte Microsoft Entra ID.
3. Sélectionnez l’authentification Entra ID : à l’étape de configuration du modèle de langage dans l’Assistant Migration, sélectionnez Microsoft Entra ID comme méthode d’authentification au lieu de la clé API.
4. Provider le point de terminaison : entrez votre URL de point de terminaison Microsoft Foundry. L’outil acquiert automatiquement le jeton d’authentification à partir de votre session connectée.

Sécurité et mise en réseau

Lorsque vous utilisez la fonctionnalité de conversion de schéma, assurez-vous que votre environnement Visual Studio Code peut se connecter en toute sécurité à votre base de données Oracle source et à l’instance de serveur flexible Azure Database pour PostgreSQL que vous utilisez comme base de données de travail.

Microsoft recommande de vous connecter à votre ressource Microsoft Foundry à l’aide d’un point de terminaison privé. Pour plus d’informations, consultez Configurer une liaison privée pour Microsoft Foundry.

Pour plus d’informations sur la sécurisation de vos connexions Microsoft Foundry, consultez Données, confidentialité et sécurité pour les modèles directs Azure dans Microsoft Foundry.

Pourquoi utiliser la fonctionnalité de conversion de schéma ?

La conversion de schémas Oracle en Azure Database pour PostgreSQL simplifie la migration et la modernisation. Elle réduit l’effort manuel et le risque en automatisant les transformations, en validant les résultats d’une base de données de travail et en fournissant une révision assistée par l’IA et une sortie optimisée par Azure prête pour le déploiement.

• Conversion automatisée : réduit l’effort manuel en convertissant automatiquement les objets de schéma compatibles.
• Transformation basée sur l’IA : utilise des modèles de langage hébergés dans Microsoft Foundry pour prendre des décisions de conversion tenant compte du contexte.
• Approche axée sur la validation : utilise des schémas temporaires pour confirmer que les objets convertis fonctionnent correctement.
• Workflow intégré : fonctionne dans l’environnement de développement Visual Studio Code.
• Connectivité Oracle flexible : prend en charge les modes client minces et épais pour la connexion aux bases de données Oracle.
• Plusieurs options d’authentification : prend en charge l’authentification par clé API et par Microsoft Entra ID pour Microsoft Foundry.
• Révision et affinement : fournit des conseils clairs pour les tâches de révision manuelle.
• Optimisation Azure : conçue pour un serveur flexible Azure Database pour PostgreSQL.

Objets de schéma pris en charge

L’outil de conversion prend en charge un large éventail d’objets de schéma et de code Oracle, notamment les éléments de définition de données, les composants au niveau du schéma et le code procédural. Bien que vous puissiez convertir automatiquement de nombreux objets courants, vous devrez peut-être examiner ou personnaliser manuellement le mappage pour certaines fonctionnalités spécifiques à Oracle ou extensions propriétaires. Pour obtenir des listes détaillées des objets pris en charge et des limitations connues, consultez les sections de cet article.

Comment les conversions sont produites

L’outil de conversion de schéma combine la traduction basée sur l’IA avec la validation automatisée pour fournir des résultats fiables. Les modèles Microsoft Foundry traduisent le DDL Oracle en PostgreSQL. L’outil compile ensuite chaque objet converti sur un schéma temporaire dans votre serveur flexible Azure Database pour PostgreSQL cible, exécute une analyse statique et applique des correctifs automatisés aux problèmes courants. Les étapes restantes du pipeline ( analyse source, extraction de métadonnées et génération de script) s’exécutent en tant qu’étapes prévisibles et basées sur des règles.

Pour les routines PL/pgSQL, l’outil ajoute une vérification de la sémantique du corps qui utilise l’extension plpgsql_check sur la base de données scratch. Lorsque la vérification détecte un défaut que la compilation simple ne intercepte pas, l’outil ignore cette routine et le renvoie via la boucle de correctif IA au lieu de l’écrire dans la sortie. Pour plus d’informations, consultez Valider pl/pgSQL converti avec plpgsql_check.

Cette approche utilise l’IA où elle ajoute la plus grande valeur et conserve le reste du workflow déterministe et vérifiable. Les objets qui ne peuvent pas être entièrement validés sont marqués comme tâches de révision afin de pouvoir les traiter avant d’appliquer le schéma converti. Pour connaître les fonctionnalités Oracle qui n'ont pas d'équivalent PostgreSQL pratique, consultez Oracle pour Azure Database pour PostgreSQL limitations de conversion de schéma de serveur flexible.

Objets de schéma de base de données

L’outil de conversion prend en charge les objets de base de données Oracle suivants :

• Tables : définitions de table, spécifications de colonnes et contraintes au niveau de la table.
• Contraintes : clés primaires, clés étrangères, contraintes uniques et contraintes de vérification.
• Index : index B-tree, index uniques et index composites.
• Séquences : objets de séquence Oracle pour les valeurs auto-incrémentées.
• Déclencheurs : déclencheurs de ligne et d’instruction.
• Vues : vues de base de données standard.
• Vues matérialisées : vues matérialisées Oracle et logique d’actualisation.
• Schémas : objets et organisation au niveau du schéma.
• Synonymes : synonymes publics et privés (avec limitations).

Objets de code Oracle

L’outil de conversion prend en charge les constructions de code Oracle suivantes :

• Déclencheurs : logique de déclencheur complexe et gestion des événements.
• Packages : spécifications et corps des packages Oracle.
• Fonctions : fonctions définies par l’utilisateur avec une logique complexe.
• Procédures stockées : procédures stockées Oracle et gestion des paramètres.
• Types et collections : types d’objets Oracle, TYPE BODY méthodes membres, VARRAYtables imbriquées et SUBTYPE déclarations.

Conversion de paquet

Les packages Oracle n’ont pas d’équivalent PostgreSQL direct. Par conséquent, l’outil convertit chaque partie d’un package en construction PostgreSQL qui conserve la surface pouvant être appelée :

• Constantes : l’outil convertit les constantes de package public en IMMUTABLE fonctions getter.
• Collections et curseurs : tables imbriquées et VARRAY devenir des domaines de tableau, où VARRAY obtient également une contrainte de longueur. Les tableaux associatifs à clé de chaîne deviennent jsonb des domaines et REF CURSOR deviennent refcursor.
• État du package : les variables de package publiques deviennent des paires getter et setter sauvegardées par un paramètre de session, qui émule l’état de session du package Oracle.
• Exceptions : les exceptions déclarées par l’utilisateur deviennent des fonctions qui retournent une SQLSTATE valeur. Par exemple, une exception initialisée avec -20001 des mappages à U0001.
• Packages de spécification uniquement : package qui n’a aucun corps converti en stubs qui déclenchent une erreur lorsqu’ils sont appelés, de sorte que la surface pouvant être appelée existe toujours.

Requêtes hiérarchiques

Les requêtes hiérarchiques Oracle sont converties en expressions de table courantes PostgreSQL WITH RECURSIVE . L’outil convertit et PRIOR se transforme en jointure de membre récursifCONNECT BY, START WITH en membre d’ancrage et LEVEL en compteur de profondeur. Il convertit SYS_CONNECT_BY_PATHégalement , , CONNECT_BY_ROOTORDER SIBLINGS BYet NOCYCLE. Après la conversion, l’outil vérifie que l’objet généré a la forme récursive attendue et réessaye la conversion si ce n’est pas le cas.

Contrôle de transaction

Une routine qui utilise PRAGMA AUTONOMOUS_TRANSACTION conserve sa classe d’objet Oracle d’origine, de sorte qu’une fonction reste une fonction et des appelants existants qui l’utilisent dans une SELECT ou expression continuent de fonctionner. Le travail autonome s’exécute sur une connexion distincte via l’extension dblink . Assurez-vous donc qu’il dblink est disponible sur le serveur cible. Une routine qui utilise un pragma explicite COMMIT ou ROLLBACK sans ce pragma se convertit en procédure, car PostgreSQL autorise le contrôle des transactions là-bas.

Valider pl/pgSQL converti avec plpgsql_check

PostgreSQL ne valide pas entièrement un corps de routine PL/pgSQL lorsque vous le créez. CREATE FUNCTION confirme que le corps analyse, mais qu’il ne résout pas les tables, colonnes et variables référencées par le corps. Une routine qui lit une colonne qui n’existe pas est créée correctement et échoue uniquement la première fois qu’elle s’exécute. Dans une migration, ce qui transforme un défaut de conversion en incident de production, car le déploiement semble propre.

L’outil de conversion de schéma ferme cet écart avec l’extension plpgsql_check . Une fois qu’une routine convertie est compilée sur la base de données scratch, l’outil exécute une vérification de la sémantique du corps sur celle-ci. Lorsque la vérification trouve un véritable défaut, l’outil ignore la routine et le retourne à la boucle de réparation IA, qui la répare et la compile à nouveau. Seules les routines qui passent sont écrites dans la sortie de conversion.

Cette validation est la principale raison pour laquelle une routine convertie est fiable avant de la déployer. Traitez plpgsql_check comme une partie requise de l’environnement de conversion plutôt qu’un supplément facultatif.

Où s’exécute la vérification

La vérification s’exécute entièrement sur la base de données scratch créée par l’outil lors de la conversion. Votre base de données cible n’a pas besoin plpgsql_check au moment de l’exécution, et rien que l’outil génère dépend de celui-ci. L’extension est une porte de qualité au moment de la conversion, et non une dépendance d’exécution.

Que se passe-t-il lorsque l’extension n’est pas disponible

La vérification échoue. Lorsqu’il plpgsql_check n’est pas autorisé ou n’est pas disponible sur le serveur qui héberge la base de données scratch, l’outil ignore la vérification et la conversion continue. Aucune erreur et aucun avertissement n’apparaît dans le rapport de conversion de schéma. Par conséquent, une exécution sans l’extension ressemble à une exécution avec celle-ci.

Les routines sont toujours compilées, de sorte que les erreurs de syntaxe sont toujours interceptées. Ce que vous perdez est la validation plus approfondie du corps, de sorte que les défauts tels qu’une colonne ou une référence de table non résolue peuvent atteindre la sortie générée et la surface plus tard au moment de l’exécution. Vérifiez que l’extension est disponible avant de vous appuyer sur les résultats de conversion.

Rendre la vérification disponible

plpgsql_checkest pris en charge sur Azure Database pour PostgreSQL serveur flexible pour PostgreSQL 14 et versions ultérieures. Autorisez l’extension, ajoutez-la et shared_preload_librariesredémarrez le serveur avant de convertir. L’outil installe ensuite l’extension sur la base de données scratch pour vous. Pour obtenir la procédure complète, consultez les meilleures pratiques d’Oracle pour Azure Database pour PostgreSQL conversion de schéma de serveur flexible.

Versions d’Oracle prises en charge

Cette section récapitule les versions du moteur de base de données qui prennent en charge la conversion de schéma automatisée et met en évidence les considérations de compatibilité. Utilisez les versions d’Oracle et PostgreSQL prises en charge pour obtenir les meilleurs résultats. Validez les conversions dans un environnement de test hors production et utilisez le dernier correctif secondaire de chaque version majeure prise en charge. Si votre environnement utilise une version non prise en charge ou inclut des fonctionnalités propriétaires Oracle, vous devrez peut-être effectuer un mappage manuel supplémentaire ou passer en revue avant le déploiement.

Les versions de base de données Oracle suivantes prennent en charge la conversion de schéma :

• Oracle 21c
• Oracle 19c
• Oracle 18c
• Oracle 12.2
• Oracle 12.1

Commentaires et support

Pour les bogues, les demandes de fonctionnalités et les problèmes liés à la fonctionnalité de conversion de schéma ou à l’extension PostgreSQL, utilisez l’outil de commentaires intégré dans Visual Studio Code. Vous pouvez accéder à cet outil de deux façons :

Menu Aide

Accédez à Aide>Signaler un problème.

Palette de commandes

1. Ouvrez la palette de commandes avec Ctrl+Shift+P (Windows/Linux) ou Cmd+Shift+P (macOS).
2. Exécutez la commande : PGSQL : Problème de rapport.

Lorsque vous créez votre problème ou fournissez des commentaires, incluez-le Schema Conversion: comme préfixe dans votre titre. Ce préfixe aide l’équipe de développement à identifier et hiérarchiser rapidement les commentaires liés à la conversion de schéma. Ce mécanisme de retour d’information aide l’équipe de développement à améliorer en permanence la fonctionnalité de conversion du schéma et à résoudre les problèmes que vous rencontrez lors de vos projets de migration d’Oracle vers Azure Database pour PostgreSQL.

Contenu connexe

• Meilleures pratiques pour Oracle pour Azure Database pour PostgreSQL conversion de schéma de serveur flexible
• Passer en revue les tâches et les dossiers de sortie d’Oracle pour Azure Database pour PostgreSQL conversion de schéma de serveur flexible
• Oracle pour Azure Database pour PostgreSQL limitations de conversion de schéma de serveur flexible