Partager via


Extension Database Migration Assessment pour Oracle

Remarque

Cette extension sera mis hors service le 15 décembre 2024. Nous cesserons de prendre en charge cet outil pour tous les problèmes qui pourront survenir et nous ne publierons plus de correctifs de bogues ni de mises à jour supplémentaires.

L’extension Database Migration Assessment pour Oracle dans Azure Data Studio vous aide à évaluer une charge de travail Oracle à migrer vers Azure SQL et Azure Database pour PostgreSQL. L’extension identifie une cible Azure SQL ou PostgreSQL appropriée avec des recommandations sur le dimensionnement approprié et des indications sur la complexité de la migration.

Prérequis

Installer l’extension Azure Data Studio

Suivez ces étapes pour installer Database Migration Assessment pour l’extension Oracle dans Azure Data Studio.

  1. Ouvrez le gestionnaire d’extensions dans Azure Data Studio. Vous pouvez sélectionner l’icône Extensions ou l’option Extensions dans le menu Affichage.

  2. Tapez Oracle dans la barre de recherche.

  3. Sélectionnez l’extensibilité Évaluation de la migration de base de données pour Oracle et examinez ses informations détaillées.

  4. Sélectionnez Installer.

    Capture d’écran de l’installation de l’extension.

Configurer les paramètres d’extension

Vous pouvez configurer plusieurs paramètres d’extension après avoir installé l’extension.

  1. Accédez aux extensions et sélectionnez Database Migration Assessment pour Oracle, sélectionnez l’icône de gestion des paramètres, puis sélectionnez Paramètres d’extension.

    capture d’écran de l’extension.

  2. Sous les paramètres d’extension, modifiez les paramètres d’extension en fonction des exigences de l’environnement.

    Capture d'écran des Jeux de propriétés de l'extension.

    Remarque

    Pour évaluer le code Oracle vers PostgreSQL, le chemin du répertoire de base du client Oracle et le chemin d’installation d’Ora2Pg sont des paramètres obligatoires.

Exécuter l’évaluation

Une fois l’extension d’évaluation installée, l’étape suivante consiste à se connecter à votre base de données Oracle, à collecter des informations de métadonnées auprès de votre instance Oracle et à générer un rapport d’évaluation.

  1. Accédez à l’icône Connexions dans la barre de menus.

    Capture d'écran de la barre des menus des connexions.

  2. Dans les Détails de la connexion, renseignez les champs.

    1. Dans le champ Type de connexion, sélectionnez Oracle.
    2. Dans le champ Source de données, tapez le nom et l’instance de votre serveur Oracle.
      1. Vous pouvez également fournir le nom TNS. (Vérifiez que la variable d’environnement ORACLE_HOME est définie et que le fichier <ORACLE_HOME>/network/admin folder se trouve dans TNSNAMES.ORA.)
      2. Pour la base de données autonome du conteneur, vous pouvez soit vous connecter à la base de données racine du conteneur en utilisant l'ID du service CDB, soit utiliser le nom du service de la base de données enfichable pour vous connecter à la base de données enfichable.
    3. Indiquez le nom d’utilisateur de la base de données dans le champ ID d’utilisateur.
    4. Indiquez le mot de passe de la base de données dans le champ Mot de passe.

    Capture d’écran de Détails de connexion.

  3. Sélectionnez Connecter.

  4. À présent, une nouvelle connexion apparaît dans le menu Détails de la connexion.

  5. Cliquez avec le bouton droit sur la connexion Oracle, puis sélectionnez Gérer.

    Capture d’écran montrant l’écran Gérer la base de données.

  6. Sélectionnez Évaluation de la migration.

    Capture d’écran montrant l’écran Évaluation de la migration de la base de données.

  7. Sélectionnez Exécuter une nouvelle évaluation.

    Capture d’écran montrant l’écran Exécuter une nouvelle évaluation.

  8. Spécifiez les détails de votre évaluation.

    1. Dans le champ Nom de l’évaluation, entrez un titre (par exemple, demo1).
    2. Entrez votre Paramètre d’évaluation.
      1. Entrez la base de données de migration de destination dans le champ Plateforme cible. Actuellement, il prend en charge Azure SQL et PostgreSQL en tant que cibles.

        Remarque

        La cible PostgreSQL est en Aperçu. Cette option cible ne sera plus disponible. Vous devez exporter toutes les évaluations antérieures.

      2. Dans la section Collecte des données de performances, sélectionnez Exécuter la collecte des données de performances sur la base de données Oracle (connecté) ou Ajouter un rapport AWR.

        Il est recommandé d’utiliser l’option « connecté » si vous exécutez cet outil pendant un pic de charge ou avec une charge réaliste. Sinon, fournissez les rapports AWR générés par le passé pour obtenir des recommandations de performances et de dimensionnement.

        Remarque

        L'option d'évaluation du rapport AWR n'est pas activée pour la base de données enfichable.

      3. Dans le champ Facteur d’échelle, entrez la valeur du multiplicateur.

        • Si la référence SKU recommandée doit prendre en compte d’autres pics de charge, le multiplicateur du facteur d’échelle doit être supérieur à 1. Par exemple, un chargement sporadique (« Burst »), une utilisation saisonnière et une planification de capacité future. Quand une charge de travail de schéma Oracle partielle est migrée, le multiplicateur doit être inférieur à 1.
      4. Dans le champ Utilisation en centile, entrez la valeur en centiles pour le dimensionnement de la cible Azure.

        • La valeur en centiles de l’exemple de performance devant être pris en compte pour le dimensionnement de la cible Azure.

    Capture d’écran montrant l’écran des détails de l’évaluation.

  9. Il existe deux types d'évaluation :

    • Évaluation de la charge de travail. Dans cette évaluation, le module d’évaluation Oracle effectue une découverte légère des objets de schéma et classe la complexité du schéma pour la migration dans différentes catégories avec une estimation générale des heures de conversion. Cette évaluation préalable permet de déterminer la faisabilité de la migration vers la plateforme cible.

    • Évaluation du code. L’évaluation du code évalue en profondeur les objets de schéma Oracle, puis suggère une préparation globale des objets de code avec des types d’objet (« prêt », « révision nécessaire » et « non prêt ») à un niveau granulaire et un nombre d’heures de conversion associé plus précis.

      Notes

      L’extension utilise un convertisseur de schéma open source Ora2Pg pour les évaluations de code.

      Si le client Oracle et/ou Ora2Pg ne sont pas installés sur la même machine qu’Azure Data Studio, installez-les manuellement ou utilisez le script d’installation Ora2Pg disponible sur GitHub.

      Si le client Oracle et Ora2Pg sont installés, vérifiez que le chemin du répertoire de base du client Oracle et le chemin d’installation d’Ora2Pg sont mis à jour dans les paramètres d’extension.

      • Lorsque vous sélectionnez l'évaluation du code pour les scénarios SQL, sélectionnez les schémas auxquels vous souhaitez accéder pour la conversion et la migration d'Oracle vers SQL. Par défaut, tous les schémas éligibles sont sélectionnés pour l'évaluation.
  10. Choisissez Exécuter la validation pour exécuter les conditions préalables et les diverses règles de validation liées aux autorisations de sécurité, aux paramètres de configuration, etc. Si la validation échoue, vous devez corriger les erreurs pour continuer.

  11. Lorsque la validation est réussie, vous pouvez sélectionner Exécuter l'évaluation.

  12. Vous voyez maintenant la nouvelle évaluation dans la section des « Cinq dernières évaluations ».

    Capture d’écran montrant l’option permettant de nommer l’évaluation.

  13. Sélectionnez le lien d’évaluation pour afficher la page des détails de l’évaluation. Vous pouvez voir l’état de l’évaluation la plus récente.

    Capture d’écran montrant l’état de l’évaluation la plus récente.

  14. Sélectionnez Actualiser ou attendez la fin de l’évaluation. Par défaut, la page d’état de l’évaluation s’actualise toutes les 15 secondes. L’état vous indique l’un des quatre états : réussite, échec, en cours ou annulé.

Examiner l’évaluation

Une fois l’évaluation terminée, une sortie unifiée utilisant des cartes est générée pour chaque cible Azure SQL : SQL Server sur Machines virtuelles Azure, Azure SQL Database et Azure SQL Managed Instance ou Azure Database pour PostgreSQL – Serveur flexible.

Capture d’écran de l’option d’affichage de l’évaluation.

Chaque carte comporte plusieurs sections. La carte indique la faisabilité globale de la migration vers la cible. Vous pouvez explorer différentes charges de travail relevant de différentes catégories de complexité de migration :

  • La section de compatibilité des fonctionnalités présente le résultat de l’examen d’évaluation des fonctionnalités.
  • La recommandation de référence SKU fournit le dimensionnement approprié de la cible.
  • L’évaluation du code fournit la complexité du code des objets de base de données.

Quand vous sélectionnez Afficher les détails du rapport, seul le récapitulatif de l’évaluation s’affiche dans un premier temps.

Capture d’écran montrant le récapitulatif de l’évaluation.

Si la cible sélectionnée est Azure Database pour PostgreSQL, l’onglet Détails de la base de données ou l’onglet Évaluation du code est visible selon le type d’évaluation sélectionné.

L’onglet Détails de la base de données présente une décomposition par schéma. Il affiche la liste des schémas découverts, la faisabilité de la migration et la durée estimée en heures de la conversion du schéma.

Capture d’écran montrant une décomposition par schéma.

Cette estimation est basée sur un modèle statistique qui s’applique au nombre d’objets, aux lignes de code, aux fonctionnalités activées et à la taille de la base de données. Pour une estimation plus précise de la conversion des codes, utilisez l'évaluation des codes.

Remarque

Les schémas système ou Oracle intégrés suivants sont exclus de l’évaluation de la charge de travail :

APEX, APPQOSSYS, AUDSYS, OWBSYS_AUDITWK_PROXYWEBSYSSYSTEMSQLTXPLAINSPATIAL_WFS_ADMIN_USRSPATIAL_CSW_ADMIN_USRPERFSTATSDEWMSYSXDBWK_TESTWKSYSSYSMANTRACESRVTSMSYSSYSSI_INFORMTN_SCHEMAWKPROXYCSMIGCTXSYSDBMS_PRIVILEGE_CAPTUREDBSFWUSERDBSNMPDIPDMSYSDVFDVSYSEXFSYSFLOW_GSMADMIN_INTERNALLBACSYSMDDATAMDSYSMGDSYSMGMT_VIEWMTMSYSODMODM_MTROJVMSYSOLAPSYSORACLE_OCMORDDATAORDPLUGINSORDSYSOSE$HTTP$ADMINOUTLNOWBSYSXS$NULL

La recommandation en matière de référence SKU fournit les éléments suivants :

  • La cible Azure appropriée.

  • Le niveau de service.

  • Les seuils des métriques sont utilisés pour communiquer la recommandation de référence SKU.

    Capture d’écran montrant la recommandation de référence SKU.

La recommandation de référence SKU évalue différentes métriques de performances : processeur, mémoire, IOPS, latence et stockage. En fonction de l’utilisation et des données de configuration, le générateur de recommandations fournit la cible qui convient et le niveau de service approprié. La recommandation en matière de référence SKU est basée sur l'utilisation de l'instance racine du conteneur ou de la base de données enfichable. La sélection du schéma est ignorée et ne s'applique pas au dimensionnement du SKU.

Remarque

Si la fonctionnalité de référentiel de charge de travail automatique (AWR) est activée sur l’instance Oracle, le générateur de recommandations de référence SKU utilise les vues DBA_HIST_ pour collecter les métadonnées de métriques de performances. Sinon, le générateur de recommandations utilise la configuration du serveur et d’autres informations de vues système pour dimensionner la cible Azure SQL.

La compatibilité du code (pour les cibles PostgreSQL uniquement) fournit un récapitulatif des objets de schéma qui peuvent être convertis en cible Azure. Le rapport décompose les objets comme ceci : objets pouvant être convertis automatiquement, objets prêts avec des conditions et objets à corriger et à convertir manuellement.

Capture d’écran montrant le rapport de compatibilité du code.

Le rapport indique le nombre total d’objets et le temps de conversion nécessaire pour migrer le code vers la base de données Azure PostgreSQL. L’image graphique présente une décomposition pour chaque type d’objet de schéma (tables, vues, clusters, etc.). Les actions sont catégorisées comme suit : « Prêt – conversion automatique », « Révision nécessaire » et « Non prêt – nécessite une conversion manuelle ».

Il est possible d’explorer les sections « Non prêt » et « Révision nécessaire » pour voir la liste des tâches de correction et le temps nécessaire pour chaque tâche.

Capture d’écran montrant la tâche de correction.

L’évaluation des fonctionnalités présente les fonctionnalités Oracle mappées à la cible de données Azure et le temps nécessaire pour migrer ces fonctionnalités vers la cible Azure.

Capture d’écran montrant l’évaluation mappée.

Vous pouvez télécharger le rapport pour un examen hors connexion en sélectionnant Télécharger des rapports combinés ou Télécharger des rapports individuels.

Capture d’écran montrant l’option de téléchargement du rapport d’évaluation.

Vous pouvez aussi annuler une évaluation en cours, supprimer une évaluation et déplacer des évaluations vers un autre répertoire.

Changer le chemin d’évaluation

  1. Accédez à la Place de marché des extensions et recherchez Database Migration Assessment for Oracle.
  2. Sélectionnez l’icône Gérer, puis Paramètres des extensions.
  3. Spécifiez le nouveau chemin de l’évaluation sous Évaluation Oracle : Chemin de l’évaluation.

Capture d’écran montrant l’option permettant de changer le chemin d’évaluation.

Dépanner

Journaux d’activité

L’extension stocke les erreurs, les avertissements et d’autres journaux de diagnostic dans le répertoire des journaux par défaut :

  • Windows - C:\Users\<username>.dmaoracle\logs\
  • Linux – ~/.dmaoracle/logs
  • macOS – /Users/<username>/.dmaoracle/logs

Notes

Par défaut, l’extension stocke les sept derniers fichiers journaux.

Pour changer le répertoire des journaux, mettez à jour la propriété LogDirectory dans le fichier de paramètres de l’extension.

Système d’exploitation Path
Windows C:\Users\<username>\.azuredatastudio\extensions\microsoft.azuredatastudio-dma-oracle-<VersionNumber>\bin\service\Properties\ConfigSettings\extension-settings.json
Linux ~/.azuredatastudio/extensions/microsoft.azuredatastudio-dma-oracle-<VersionNumber>/<VersionNumber>/bin/service/Properties/ConfigSettings/extension-settings.json
macOS /Users/<username>/.azuredatastudio/extensions/microsoft.azuredatastudio-dma-oracle-<VersionNumber>/<VersionNumber>/bin/service/Properties/ConfigSettings/extension-settings.json

Pour plus d’informations sur la résolution des problèmes, consultez Résolution des problèmes Database Migration Assessment concernant les erreurs d’extension Oracle.

Problèmes connus et limitations

  • Le chemin fourni n’existe pas.

    Raison : Fichiers manquants ou autorisation manquante sur le dossier de l’évaluation.

    Solution possible :

    • L’utilisateur dispose d’autorisations de lecture et d’écriture sur le dossier d’évaluation.
    • Si un fichier ou un dossier est manquant, supprimez l’évaluation et générez-en une nouvelle.
  • Exception de délai d’expiration de connexion rencontrée lors de l’interaction avec Oracle.

    Raison : Échec de connexion à l’instance Oracle.

    Solution possible :

    • Vérifiez si les règles de pare-feu bloquent le port d’écoute Oracle.
    • Exécutez tnsping et vérifiez si l’ID de service est résolu.

Contacter Microsoft pour obtenir de l’aide

Si vous avez besoin d’une assistance supplémentaire de la part de Microsoft, contactez @dmasupport. Pour accélérer le traitement de votre demande, vous pouvez attacher les journaux à partir du répertoire de journaul d’activité par défaut.